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您 购买 的 图 灵 电 子 书 仅 供 您 个 人 使 用 ， 未 经 授权 ， 不 得 以 任何 方式 复制 
和 传播 本 书 内 容 。 


我 们 愿意 相信 读者 具有 这 样 的 恨 知 和 觉悟 ， 与 我 们 共同 保护 知识 产权 。 


如 果 购 买 者 有 侵权 行为 ， 我 们 可 能 对 该 用 户 实施 包括 但 不 限于 关闭 该 帐 
写 等 维权 措施 ， 并 可 能 退 完 法 律 贡 任 。 
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采 言 


虽然 我 从 事 Android 开 发 工作 已 经 很 多 年 了 ， 但 是 之 前 从 来 没有 想 过 自 
己 要 去 写 一 本 Android 技 术 相 关 的 书 。 在 我 看 来 ， 写 一 本 书 可 以 算是 一 
个 很 庞大 的 工程 ， 写 一 本 好 书 的 难度 并 不 亚 于 开发 一 款 好 的 应 用 程序 。 


由 于 我 长 期 坚持 在 CSDN 上 友 表 技术 博文 ， 因 而 得 到 了 大 量 网 友 的 认 
可 ， 也 积累 了 一 定 的 名 气 。 很 案 幸 的 是 ， 人 民 邮 电 出 版 社 图 灵 公 司 的 前 
副 总 编辑 陈 冰 老 师 联 系 上 了 我 ， 和 希望 我 可 以 写 一 本 关于 Android 开 发 拉 
术 的 书 ， 这 大 实 让 我 受 宠 耕 慰 。 


在 写本 书 第 1 版 的 时 候 ， 我 可 以 说 是 费 了 相当 大 的 心 上 息 。 写 书 和 写 博客 
最 大 的 区 别 在 于 ， 书 的 内 容 不 能 像 博客 那样 散乱 ， 不 能 想到 哪里 写 到 哪 
里 ， 而 是 一 定 和 要 系统 化 ， 要 循序 渐进 ， 基 本 上 在 写 第 1 章 的 时 候 就 应 该 
把 全 书 的 内 容 都 确定 下 来 了 。 


令 我 非 第 欣慰 的 是 ， 本 书 的 第 1 版 在 推出 之 后 获得 了 广大 读者 的 强烈 认 
可 ， 在 短 短 两 年 时 间 内 ， 已 经 成 为 了 国内 最 畅销 的 Android 技 术 书 。 各 
大 书店 、 图 书馆 都 能 看 到 《第 一 行 代码 》 的 号 影 ， 许 多 学 校 和 培训 机 构 
也 纷纷 将 《第 一 行 代码 》 选 为 Android 课 程 的 教材 。 


不 过 ， 在 科技 高 速 发 展 的 今天 ， 各 种 技术 的 发 展 都 是 日 新 月 异 的 。 在 两 
年 的 时 间 里 ，Android 操 作 系 统 经 历 了 5.0、6.0、7.0 的 飞速 升级 。 不 可 否 
认 的 是 ， 本 书 第 1 版 中 的 不 少 知识 点 都 已 经 过 时 ， 而 且 这 两 年 间 出 现 的 
oa 
想法。 


刚 开始 写 的 时 候 ， 我 以 为 只 是 小 修 小 补 ， 但 事实 上 并 没有 我 想象 得 那么 
轻松 。 除 了 介绍 新 知识 点 以 外 ， 书 中 之 前 的 所 有 项 目 都 需要 重新 编写 和 
测试 ， 以 保证 代码 在 新 老 系统 上 的 兼容 性 。 另 外 ， 由 于 Android 从 5.0 系 
统 开 始 ，UI 风 格 变化 很 大 ， 因 此 第 1 版 中 所 有 的 截图 都 需要 更 新 。 晶 不 
夸张 地 说 ， 我 几乎 重 写 了 整 本 书 。 


而 现在 ， 你 手中 捧 着 的 正 是 全 新 版 的 《第 一 行 代 码 》， 同 时 这 也 是 国内 
第 一 本 基于 Android 7.0 系 统 写作 的 技术 书 。 我 真 减 地 硕 望 你 可 以 用 心 去 
阅读 这 本 书 ， 因 为 每 多 掌握 一 份 知识 ， 你 就 会 多 一 份 喜悦 。Enjoy itl 












































第 2 版 的 变化 


由 于 第 2 版 修改 内 容 繁 多 ， 因 此 这 里 我 只 列举 出 最 主要 的 变化 。 首 先是 

开发 工具 上 的 改变 ， 本 书 第 1 版 使 用 的 开发 工具 是 Eclipse， 而 第 2 版 使 用 
了 目前 最 新 的 Android Studio 2.2 版 本 。 另 外 ， 本 书 第 1 版 是 基于 Android 
4.x 系 统 的 ， 而 第 2 版 是 基于 Android 7.0 系 统 的 ， 其 中 吕 括 了 新 系统 中 的 
诸多 知识 点 ， 包 括 Android 5.0 系 统 中 引入 的 Material Design、Android 6.0 
系统 中 引入 的 运行 时 权限 和 Doze 模 式 、Android 7.0 系 统 中 引入 的 多 窗口 


模式 等 。 


除 此 之 外 ， 第 2 版 还 加 入 了 Gradle、RecyclerView、 百 分 比 布局 、 
OkHttp、Lambda 表 达 式 等 全 新 知识 点 的 讲解 ， 内 容 将 前 所 未 有 地 充 














读者 对 象 


本 书 内 容 通 俗 易 履 ， 由 浅 入 深 ， 既 适合 初学 者 阅读 ， 也 同样 适合 专业 人 
员 。 学 习 本 书 内 容 之 前 ， 你 并 不 需要 有 任何 的 Android 基 础 ， 但 是 你 需 
要 有 一 定 的 Java 基 础 ， 因 为 Android 开 发 都 是 使 用 Java 语 言 的 ， 而 本 书 并 
不 会 去 专门 介绍 Java 方 面 的 知识 。 


阅读 本 书 时 ， 你 可 以 根据 自身 的 情况 来 决定 如 何 阅读 。 如 果 你 是 初学 者 
的 话 ， 建 议 你 从 第 1 章 开 始 循序 渐进 地 阅读 ， 这 样 理解 起 来 就 不 会 感到 
吃力 。 而 如 果 你 已 经 有 了 一 定 的 Android 基 础 ， 那 么 就 可 以 选择 某 些 你 
感 兴趣 的 章节 进行 跳跃 式 的 阅读 。 但 请 记 住 ， 很 多 章 最 后 的 最 佳 实践 部 
分 一 定 是 你 不 想 错 过 的 。 




















本 书 内 容 


正如 前 面 所 说 ， 本 书 的 内 容 是 非常 系统 化 的 ， 不 仅 全 面 介绍 了 那些 你 必 
须 掌 握 的 知识 ， 而 且 保 证 了 各 章 的 难度 都 是 梯度 式 上 升 的 。 全 书 一 共 分 
为 15 章 ， 涵 盖 了 四 大 组 件 、UI、 雁 请 、 数 据 存储 、 多 媒体 、 网 络 、 定 位 
服务 等 方方面面 的 知识 。 为 了 让 你 在 学 完 所 有 内 容 之 后 还 可 以 有 综合 运 
用 的 能 力 ， 本 书 的 尾声 部 分 还 会 带 你 一 起 开发 一 个 天 气 预报 程序 ， 并 教 
会 你 如 何 将 程序 发 布 到 应 用 商店 ， 以 及 如 何在 程序 中 藤 入 广告 便利 。 


除 此 之 外 ， 本 书 的 第 5 章 、 第 7 章 、 第 11 章 、 第 14 章 中 都 穿插 有 对 Git 的 
讲解 ， 如 果 想 要 掌握 它 的 用 法 ， 这 几 章 的 内 容 是 绝对 不 能 错过 的 。 


本 书 中 各 个 章节 的 内 容 都 相对 比较 独立 ， 因 此 除了 可 以 循序 渐进 地 学 习 
之 外 ， 你 还 可 以 把 它 当 成 一 本 参考 手册 ， 随 时 查阅 。 




















源 但 下 载 


首先 ， 我 建议 你 在 学 习 本 书 的 时 候 将 所 有 项 目的 源码 都 杀手 襄 上 一 过 ， 
因为 只 有 这 样 才能 加 深 你 对 代码 的 理解 。 不 过 为 了 方便 于 你 的 学 习 ， 我 
还 是 提供 了 书 中 所 有 项 目的 源码 ， 请 仅 在 需要 的 时 候 再 去 参考 (如 下 载 
项 目 中 的 图 片 资源 ) 。 切 勿 直接 将 源码 复制 粘贴 就 当成 自己 的 东西 了 ， 
只 有 亲手 殴 过 的 代码 才 真 正 是 你 自己 的 。 


源码 下 载 地 址 :https://github.com/guolindev/booksource。 

















致谢 


在 这 近 一 年 的 时 间 里 ， 我 又 完成 了 一 项 浩大 的 工程 。 和 写作 本 书 第 1 版 
时 的 感 党 类似， 当 全 书 完稿 之 后 ， 回 顾 整 本 书 ， 我 仍然 不 敢 相 信 这 所 有 
的 内 容 苋 然 是 我 一 字 字 地 敲 出 来 的 。 


如 今 这 已 经 是 我 写 的 第 二 本 书 了 ， 和 写 第 一 本 书 时 的 情况 不 同 ， 现 在 我 
有 了 更 广 的 人 脉 和 资源 ， 有 了 更 多 的 人 愿意 帮助 和 支持 我 来 完成 一 本 更 
好 的 技术 书 。 因 此 ， 我 要 在 这 里 对 很 多 人 表示 感谢 。 


首先 我 要 感谢 我 的 父母 ， 感 谢 你 们 将 我 抚养 长 大 ， 感 谢 你 们 的 付出 ， 让 
我 从 小 不 用 为 生计 、 上 学 而 发 悉 ， 可 以 一 直 做 我 自己 想 做 的 事情 ， 也 感 
谢 你 们 指引 我 走 上 了 技术 这 条 路 。 


其 次 我 要 感谢 我 的 妻子， 感谢 你 每 天 为 我 准备 好 一 日 三 餐 ， 感 谢 你 对 我 
永远 的 包容 ， 不 管 是 平日 的 加 班 还 是 没 日 没 夜 的 写 书 ， 你 都 一 直上 默默 地 
理解 和 支持 我 。 


我 还 非常 感谢 本 书 第 1 版 的 编辑 陈 冰 老师 ， 如 果 没 有 你 当初 在 CSDN 上 找 

到 我 ， 并 人 邀请 我 写 书 ， 殊 不 会 有 现在 的 《第 一 行 代码 》。 男 外 ， 你 也 是 

0 
J 眼花 。 


我 也 非常 感谢 本 书 第 2 版 的 编辑 张 霞 ， 你 全 程 负责 了 第 2 版 的 出 版 工作 ， 
并 且 完 成 得 非常 出 色 。 你 对 文字 的 把 控 能 力 让 我 敬佩 ， 感 谢 你 对 书 中 每 
一 章节 的 尽心 审阅 ， 才 能 让 这 本 书 更 趋 近 于 完美 。 


男 外 我 还 要 特别 感谢 一 部 分 人 ， 你 们 在 对 本 书 的 内 容 建议 、 勘 误 检 查 、 
代码 纠 错 ， 甚 至 是 对 我 个 人 的 支持 等 方面 部 作出 了 蛙 越 的 页 献 。 有 了 你 
们 的 帮助 ， 才 会 有 这 样 一 本 更 加 出 色 的 书 呈现 在 所 有 人 面前 ， 这 本 书 上 
也 理应 有 你 们 的 名 字 《〈 按 姓氏 拼音 排序 ， 排 名 不 分 先后 ) : 


陈 建 林 陈 俊杰 陈 雷 陈 龙 陈 琪 陈 秀 相 陈 逸 鸣 代 云 
蛟 ”重生 轩 段 缉 和 森 


高 乱 果 ”高 太 稳 ”关爱 民 何以 诚 胡 恩 泽 黄 楠 赖 帆 李 济 























洲 ， 李 建 友 ” 李 沛 明 


李 潭 李 水 鹏 李 志 云 


俊 罗 亚 超 ” 吕 国 完 


马 文 术 “ 覃 文坛 “ 孙 建 习 
路 王 鹏 王 采 和 宗 
王 善 昌 韦 振 南 吴 波 
辉 易 静 杰 查 童 
张 鸿 洋 “ 张 英 祥 “ 赵 浴 龙 
锋 周 苏 朱 海 丰 





刘 明 渊 ， 刘 治国 





赵 迎 超 


ES 二 炎 


徐 阳 轩 仲 宽 


郑 传 书 ” 郑 敏 声 





第 1 草 开始 局 程 一 一 你 的 第 一 行 


Android 代 三 


欢迎 你 来 到 Android 世 界 ! Android 系 统 是 目前 世界 上 市 场 占 有 率 最 高 的 
移动 操作 系统 ， 不 管 你 在 哪里 ， 都 可 以 看 到 Android 手 机 几乎 无 处 不 
在 。 今 天 的 Android 世 界 可 谓 欣 欣 癌 荣 ， 可 是 你 知道 它 的 过 去 是 什么 样 
的 吗 ? 我 们 一 起 来 看 一 看 它 的 发 展 史 吧 。 


2003 年 10 月 ，Andy Rubin 等 人 一 起 创办 了 Android 公 司 。2005 年 8 月 谷歌 
收购 了 这 家 仅仅 成 立 了 22 个 月 的 公司 ， 并 让 Andy Rubin 继 续 负 责 
Android 项 目 。 在 经 过 了 数 年 的 研发 之 后 ， 谷 歌 终 于 在 2008 年 推出 了 
Android 系 统 的 第 一 个 版 本 。 但 目 那 之 后 ，Android 的 发 展 束 一 直 受 到 重 
重 阴 拱 。 乔 布 斯 自始至终 认为 Android 是 一 个 抄袭 iPhone 的 产品 ， 里 面 简 
鳃 了 诸多 iPhone 的 创意 ， 并 声称 一 定 要 虹 挥 Android。 而 本 里 就 是 基于 
Linux 开 发 的 Android 操 作 系 统 ， 在 2010 年 被 Linux 团 队 从 Linux 内 核 主线 
中 除名 。 又 由 于 Android 中 的 应 用 程序 都 是 使 用 Java 开 发 的 ， 甲 骨 文 则 针 
对 Android 侵 犯 Java 知 识 产 权 一 事 对 谷歌 提起 了 诉讼 ..….. 


可 是 ， 似 乎 再 多 的 困难 也 阻挡 不 了 Android 快 速 前 进 的 步伐 。 由 于 谷歌 
的 开放 政策 ， 任 何 手 机 广 商 和 个 人 都 能 免费 获取 到 Android 操 作 系 统 的 
源码 ， 并 且 可 以 自由 地 使 用 和 定制 。 三 星 、HTC、 摩 托 罗 拉 、 索 爱 等 公 
司 都 推出 了 各 自 系 列 的 Android 手 机 ，Android 市 场 上 百花 齐 放 。 仅 仅 推 
出 两 年 后 ，Android 就 超过 了 已 经 条 占 市 场 傅 十 年 的 诺基亚 Symbian， 成 
为 了 全 球 第 一 大 智能 手机 操作 系统 ， 并 且 每 天 都 还 会 有 数 百 万 台新 的 
Android 设 备 被 激活 。 而 近 几 年 ， 国 内 的 手机 厂商 也 是 大 放 异 彩 ， 小 
米 、 华 为 、 魅 族 等 新 兴 品 牌 都 推出 了 相当 不 错 的 Android 手 机 ， 并 且 也 
获得 了 市 场 的 广泛 认可 ， 有 目前 Android 已 经 占据 了 全 球 智能 手机 操作 系 
统 70% 以 上 的 份额 。 


说 了 这 些 ， 想 必 你 已 经 体会 到 Android 系 统 和 炙手可热 的 程度 ， 并 且 迫 不 

及 竺 地 想 要 加 入 到 Android 开 发 者 的 行列 当中 了 吧 。 试 想 一 下 ， 十 个 人 

中 有 七 个 人 的 手机 都 可 以 运行 你 编写 的 应 用 程序 ， 还 有 什么 能 比 这 个 更 
诱 人 的 呢 ? 那么 从 今天 起 ， 我 承 带 你 踏 上 学 习 Android 的 旅途 ， 一 步 步 

地 引导 你 成 为 一 名 出 色 的 Android 开 发 者 。 























好 了 ， 现 在 我 们 就 来 一 起 初 血 一 下 Android 世 界 吧 。 


1.1 了 解 全 貌 一 “Android 王国 简介 


Android 从 面世 以 来 到 现在 已 经 发 布 了 二 十 几 个 版 本 了 。 在 这 几 年 的 发 
展 过 程 中 ， 谷 歌 为 Android 王 国 建立 了 一 个 完整 的 生态 系统 。 手 机 广 
商 、 开 发 者 、 用 户 之 间 相 互 依存 ， 共 同 推 进 着 Android 的 办 动 发 展 。 开 
发 者 在 其 中 扮演 着 不 可 或 缺 的 角色 ， 因 为 如 果 没 有 开发 者 来 制作 丰富 的 
应 用 程序 ， 那 么 不 管 多 么 优秀 的 操作 系统 ， 也 是 难以 得 到 大 众 用 户 喜 爱 
的 ， 相 信 没 有 多 少 人 能 够 忍受 没有 QQ、 微 信 的 手机 吧 。 而 且 ， 舍 歌 推 
出 的 Google Play 更 是 给 开发 者 市 来 了 大 量 的 机 遇 ， 只 要 你 能 制作 出 优秀 
的 产品 ， 在 Google Play 上 获得 了 用 户 的 认可 ， 你 就 完全 可 以 得 到 不 错 的 
经 济 回 报 ， 从 而 成 为 一 名 独立 开发 者 ， 甚 至 是 成 功 创业 ! 


那 我 们 现在 就 以 一 个 开发 者 的 角度 ， 去 了 解 一 下 这 个 操作 系统 吧 。 纯 理 
论 型 的 东西 也 比较 无 聊 ， 怕 你 看 睡 着 了 ， 因 此 我 只 挑 重点 介绍 ， 这 些 东 
西 跟 你 以 后 的 开发 工作 都 是 息息相关 的 。 
1.1.1 Android 系统 架 构 
为 了 让 你 能 够 更 好 地 理解 Android 系 统 是 怎么 工作 的 ， 我 们 先 来 看 一 下 
它 的 系统 架构 。Android 大 致 可 以 分 为 四 层 架 构 : Linux 内 核 层 、 系 统 运 
行 库 层 、 应 用 框架 层 和 应 用 层 。 
1. Linux 内 核 层 
Android 系 统 是 基于 Linux 内 核 的 ， 这 一 层 为 Android 设 备 的 各 种 人 硬件 
提供 了 底层 的 驱动 ， 如 显示 驱动 、 音 频 驱 动 、 照 相机 驱动 、 蓝 牙 驱 
动 、Wi-Fi 驱 动 、 电 源 管理 等 。 
2. 系统 运行 库 层 
这 一 层 通过 一 些 C/C++ 库 来 为 Android 系 统 提供 了 主要 的 特性 支持 。 
如 SQLite 库 提供 了 数据 库 的 支持 ，OpenGLIES 库 提供 了 3D 绘 图 的 支 
持 ，Webkit 库 提供 了 浏览 器 内 核 的 支持 等 。 


同样 在 这 一 层 还 有 Android 运 行 时 库 ， 它 主要 提供 了 一 些 核心 库 ， 











能 够 允许 开发 者 使 用 Java 语 言 来 编写 Android 应 用 。 男 外 ，Android 
运行 时 库 中 还 包含 了 Dalvik 虚 拟 机 (5.0 系 统 之 后 改 为 ART 运 行 环 

境 ) ， 它 使 得 每 一 个 Android 应 用 都 能 运行 在 独立 的 进程 当中 ， 并 
且 拥 有 一 个 上 自己 的 Dalvik 虚 拟 机 实例 。 相 较 于 Java 虚 拟 机 ，Dalvik 

是 专门 为 移动 设备 定制 的 ， 它 针对 手机 内 存 、CPU 性 能 有 限 等 情况 
做 了 优化 处 理 。 


. 应 用 框架 层 

这 一 层 主要 提供 了 构建 应 用 程序 时 可 能 用 到 的 各 种 API，Android 自 
带 的 一 些 核心 应 用 就 是 使 用 这 些 API 完 成 的 ， 开 发 者 也 可 以 通过 使 
用 这 些 API 来 构建 自己 的 应 用 程序 。 

.应 用 层 

所 有 安装 在 手机 上 的 应 用 程序 都 是 属于 这 一 层 的 ， 比 如 系统 自 带 的 
联系 人 人、 短信 等 程序 ， 或 者 是 你 从 Google Play 上 下 载 的 小 游戏 ， 当 
然 还 包括 你 自己 开发 的 程序 。 


结合 图 1.1 你 将 会 理解 得 更 加 深刻 ， 图 片 源 目 维基 百科 。 
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图 1.1 _ Android 系统 架 构 


1.1.2 ” Android 已 发 布 的 版 本 


2008 年 9 月 ， 谷 歌 正式 发 布 了 Android 1.0 系 统 ， 这 也 是 Android 系 统 最 早 
的 版 本 。 随 后 的 几 年 ， 谷 歌 以 惊人 的 速度 不 断 地 更 新 Android 系 统 ， 
2.1、2.2、2.3 系 统 的 推出 使 Android 占 据 了 大 量 的 市 场 。2011 年 2 月 ， 谷 
歌 发 布 了 Android 3.0 系 统 ， 这 个 系统 版 本 是 专门 为 平板 电脑 设计 的 ， 但 
也 是 Android 为 数 不 多 的 比较 失败 的 版 本 ， 推 出 之 后 一 直 不 见 什么 起 
色 ， 市 场 份 额 也 少 得 可 怜 。 不 过 很 快 ， 在 同年 的 10 月 ， 谷 歌 又 发 布 了 
Android 4.0 系 统 ， 这 个 版 本 不 再 对 手机 和 平板 进行 差异 化 区 分 ， 既 可 以 
应 用 在 手机 上 ， 也 可 以 应 用 在 平板 上 。2014 年 Google WO 大 会 上 ， 谷 歌 


推出 了 号 称 史上 版 本 改动 最 大 的 Android 5.0 系 统 ， 其 中 使 用 ART 运 行 环 
境 奉 代 了 Dalvik 虚 拟 机 ， 大 大 提升 了 应 用 的 运行 速度 ， 还 提出 了 Material 
Design 的 概念 来 优化 应 用 的 界面 设计 。 除 此 之 外 ， 还 推出 了 Android 
Wear、Android Auto、Android TV 系统 ， 从 而 进军 可 罕 戴 设备 、 汽 车 、 
电视 等 全 新 领域 。 之 后 Android 的 更 新 速度 更 加 迅速 ，2015 年 Google IO 
大 会 上 推出 了 Android ”6.0 系统， 加 入 运行 时 权限 功能 ，2016 年 Google 
IO 大 会 上 推出 了 Android 7.0 系 统 ， 加 入 多 窗口 模式 功能 ， 这 也 是 目前 最 
新 的 Android 系 统 版 本 。 


下 表 列 出 了 目前 主要 的 Android 系 统 版 本 及 其 详细 信息 。 你 看 到 这 张 表 
格 时 ， 数 据 可 能 已 经 友 生 了 变化 ， 查 看 最 新 的 数据 可 以 访问 


http://developer.android.google.cn/about/dashboards/。 
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从 上 表 中 可 以 看 出 ， 目 前 4.0 以 上 的 系统 已 经 占据 了 超过 98% 的 Android 
市 场 份额 ， 因 此 我 们 本 书 中 开发 的 程序 也 只 面 癌 4.0 以 上 的 系统 ，2.x 的 
系统 就 不 再 去 兼容 了 。 


1.1.3 Android 应 用 开发 特色 





预告 一 下 ， 你 马上 就 要 开始 真正 的 Android 开 发 旅程 了 。 不 过 先 别 急 ， 
在 开始 之 前 我 们 再 来 一 起 看 一 看 ，Android 系 统 到 底 提供 了 哪些 东西 ， 
可 供 我 们 开发 出 优秀 的 应 用 程序 。 


. 四 大 组 件 
Android 系 统 四 大 组 件 分 别 是 活动 (Activity) 、 服 务 (Service) 、 
广播 接收 器 (Broadcast Receiver) 和 内 容 提 供 器 (Content 





Provider) 。 其 中 活动 是 所 有 Android 应 用 程序 的 门面 ， 凡 是 在 应 用 
中 你 看 得 到 的 东西 ， 都 是 放 在 活动 中 的 。 而 服务 就 比较 低调 了 ， 你 
无 法 看 到 它 ， 但 它 会 一 直 在 后 合 默默 地 运行 ， 即 使 用 户 退 出 了 应 

用 ， 服 务 仍然 是 可 以 继续 运行 的 。 广 播 接收 器 允许 你 的 应 用 接收 来 
目 各 处 的 广播 消息 ， 比 如 电话 、 短 信 等 ， 当 然 你 的 应 用 同样 也 可 以 
回 外 发 出 广播 消 有 息 。 内 容 提 供 器 则 为 应 用 程序 之 间 共 享 数 据 提供 了 
可 能 ， 比 如 你 想 要 读 取 系统 电话 每 中 的 联系 人 ， 就 需要 通过 内 容 提 
供 嚣 来 实现 。 


. 丰富 的 系统 控件 

Android 系 统 为 开发 者 提供 了 丰富 的 系统 控件 ， 使 得 我 们 可 以 很 轻 
松 地 编写 出 漂亮 的 界面 。 当 然 如 果 你 品位 比较 高 ， 不 满足 于 系统 自 
带 的 控件 效果 ， 也 完全 可 以 定制 属于 自己 的 控件 。 
.SQLite 数 据 库 

Android 系 统 还 自 带 了 这 种 轻 量 级 、 运 算 速 度 极 快 的 嵌入 式 关系 型 
数据 库 。 它 不 仅 支 持 标准 的 SQL 语法 ， 还 可 以 通过 Android 封 装 好 
的 API 进 行 操 作 ， 让 存储 和 读 取 数据 变 得 非常 方便 。 

. 强大 的 多 媒体 

Android 系 统 还 提供 了 丰富 的 多 媒体 服务 ， 如 音乐 、 视 频 、 录 音 、 
拍照 、 闸 铃 ， 等 等 ， 这 一 切 你 都 可 以 在 程序 中 通过 代码 进行 控制 ， 
让 你 的 应 用 变 得 更 加 丰富 多 彩 。 

. 地 理 位 置 定 位 

移动 设备 和 PC 相 比 起 来 ， 地 理 位 置 定位 功能 应 该 可 以 算是 很 大 的 














一 个 亮点 。 现 在 的 Android 手 机 都 内 置 有 GPS， 走 到 哪儿 都 可 以 定位 
到 自己 的 位 置 ， 发 挥 你 的 想象 就 可 以 做 出 创意 十 足 的 应 用 ， 如 果 再 
结合 功能 强大 的 地 图 功能 ，LBS 这 一 领域 潜力 无 限 。 


既然 有 Android 这 样 出 色 的 系统 给 我 们 提供 了 这 么 丰富 的 工具 ， 你 还 用 
担心 做 不 出 优秀 的 应 用 吗 ? 好 了 ， 纯 理论 的 东西 就 介绍 到 这 里 ， 我 知道 
你 已 经 迫不及待 想 要 开始 真正 的 开发 之 旅 了 ， 那 我 们 束 开 始 局 程 吧 ! 








1.2 手把手 带 你 搭建 开发 环境 


俗话 说 得 好 ,“ 工 欲 善 其 事 ， 必 先 利 其 器 ”， 开 着 记事 本 就 想 去 开发 
Android 程 序 显 然 不 是 明智 之 举 ， 选 择 一 个 好 的 IDE 可 以 极 大 幅度 地 提高 
你 的 开发 效率 ， 因 此 本 节 我 就 将 手把手 带 着 你 把 开发 环境 搭建 起 来 。 


1.2.1 准备 所 需要 的 工具 


我 现在 对 你 了 解 还 并 不 多 ， 但 我 希望 你 已 经 是 一 个 颇 有 经 验 的 Java 程 序 
员 ， 这 样 你 理解 本 书 的 内 容 时 将 会 轻而易举 ， 因 为 Android 程 序 都 是 使 
用 Java 语 言 编写 的 。 如 果 你 对 Java 只 是 略 有 了 解 ， 那 阅读 本 书 应 该 会 有 
一 点 困难 ， 不 过 一 边 阅 读 一 边 补充 Java 知 识 也 是 可 以 的 。 但 如 果 你 对 
Java 完 全 没有 了 解 ， 那 么 我 建议 你 可 以 暂时 将 本 书 放下 ， 先 买 本 介绍 
Java 基 础 知识 的 书 学 上 两 个 星期 ， 把 Java 的 基本 语法 和 特性 都 学 会 了 ， 
再 来 继续 阅读 这 本 书 。 


好 了 ， 既 然 你 已 经 阅读 到 这 里 ， 说 明 你 已 经 掌握 Java 的 基本 用 法 了 ， 下 
面 我 们 就 来 看 一 看 开发 Android 程 序 需要 准备 哪些 工具 。 














。JDK。JDK 是 Java 语 言 的 软件 开发 工具 包 ， 它 包含 了 Java 的 运行 环 
境 、 工 具 集 合 、 基 础 类 库 等 内 容 。 需 要 注意 的 是 ， 本 书 中 的 
Android 程 序 必 须要 使 用 JDK 8 或 以 上 版 本 才能 进行 开发 。 


Android SDK。Android SDK 是 谷歌 提供 的 Android 开 发 工具 包 ， 在 
开发 Android 程 序 时 ， 我 们 需要 通过 引入 该 工具 包 ， 来 使 用 Android 
相关 的 API。 


Android Studio。 在 很 早 之 前 ，Android 项 目 都 是 用 Eclipse 来 开发 
的 ， 相 信 所 有 Java 开 发 者 都 一 定 会 对 这 个 工具 非常 熟悉 ， 它 是 Java 
开发 神 费 ， 安 装 ADT 插 件 后 就 可 以 用 来 开发 Android 程 序 了 。 而 在 
2013 年 的 时 候 ， 谷 歌 推 出 了 一 于 官方 的 IDE 工 具 Android Studio， 由 
于 不 再 是 以 插件 的 形式 存在 ，Android Studio 在 开发 Android 程 序 方 
面 要 远 比 Eclipse 强大 和 方便 得 多 。 不 过 由 于 Android Studio 早 期 的 测 
试 版 本 并 不 是 非常 稳定 ， 所 以 本 书 的 第 1 版 仍然 选用 Eclipse 来 作为 


开发 工具 。 而 如 今 ，Android _ Studio 已 经 推出 了 2.2 版 本 ， 稳 定性 完 
全 不 再 是 问题 ， 普 及 程度 方面 也 远 超 Eclipse， 没 有 比 现 在 更 适合 的 
时 机 来 换 用 Android Studio 了 ， 因 此 本 书 中 所 有 的 代码 都 将 在 
Android Studio 上 进行 开发 。 


1.2.2 ”搭建 开发 环境 


当然 ， 上 述 软件 并 不 需要 你 去 一 个 个 地 下 载 ， 因 为 谷歌 为 了 简化 搭建 开 
发 环境 的 过 程 ， 将 所 有 需要 用 到 的 工具 都 帮 我 们 集成 好 了 ， 到 Android 
官网 就 可 以 下 载 最 新 的 开发 工具 ， 下 载 地 址 

是 : https://developer.android.google.cn/studio/index.html。 不 过 ，Android 
官网 通常 都 需要 科学 上 网 才能 访问 ， 如 果 你 无 法 访问 的 话 ， 也 可 以 直接 
到 我 的 百度 网 盘 去 下 载 ， 下 载 地 址 

是 : https:/pan.baidu.com/s/IlnuABMDb。 (注意 网 址 中 是 阿拉 伯 数 字 1， 
而 不 是 英文 字母 1]。) 


你 下 载 下 来 的 将 是 一 个 安装 包 ， 安 装 的 过 程 也 很 简单 ， 一 直 点 击 Next 束 
可 以 了 。 其 中 选择 安装 组 件 时 建议 全 部 勾 上 ， 如 图 1.2 所 示 。 
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图 1.2 选择 安装 组 件 
接 下 来 还 会 让 你 选择 Android Studio 的 安装 地 址 以 及 Android SDK 的 安装 
地 址 ， 这 些 根据 你 自己 电脑 的 实际 情况 选择 就 行 了 ， 不 想 改 动 的 话 就 保 
持 默 认 ， 如 图 1.3 所 示 。 








Configuration Settings 


Install Locations 





Android Studio Installation Location 


The location specified must have at least 500MB of free space., 
Click Browse to customize: 


C:\Program FilesWwndroidWwndroid Studio 





Android SDK Installation Location 


The location specified must have at least 3.,2GB of free space, 
Click Browse to customize: 


C:WsersWwdministratorWppDataVocalwndroid\sdk 





图 1.3 选择 安装 地 址 


后 面 就 没什么 需要 注意 的 了 ， 全 部 保持 默认 项 ， 一 直 点 击 Next 即 可 完成 
安装 ， 如 图 1.4 所 示 。 
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图 1.4 安装 完成 
现在 点 击 Finish 按 钮 来 启动 Android Studio， 一 开始 会 让 你 选择 是 否 导 入 
之 前 Android Studio 版 本 的 配置 ， 由 于 这 是 我 们 首次 安装 ， 这 里 选择 不 导 
入 就 可 以 了 ， 如 图 1.5 所 示 。 





You can import your settings from a previous version of Studio. 
I want to import my settings from a custom location 


Specify config folder or installation home of the previous version of Studio: 


© I do not have a previous version of Studio or I do not want to import my settings 


图 1.5 选择 不 导入 配置 
点 击 OK 按钮 会 进入 到 Android Studio 的 配置 界面 ， 如 图 1.6 所 示 。 


Welcome 


人 以 Android Studio 


Welcome back! This setup wizard will validate your current Android SDK and 
development environment setup. You will have the option to download a new Android 
SDK or use an existing installation. Once the setup wizard completes, you can 
import an existing Android app into Android Studio or start a new Android project. 


有 三 
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图 1.6 Android Studio 的 配置 界面 
然后 点 击 Next 开 始 进行 具体 的 配置 ， 如 图 1.7 所 示 。 


人 Install Type 


Choose the type of setup you want for Android Studio: 


© Standard 


Android Studio will be installed with the most common settings and options. 
Recommended for most users. 


OO Custom 


You can customize installation settings and components installed, 


Lo] EE | conce! | | rinisn | 





图 1.7 选择 安装 类 型 


这 里 我 们 可 以 选择 Android ”Studio 的 安装 类 型 ， 有 Standard 和 Custom 两 
种 。Standard 表 示 一 切 都 使 用 默认 的 配置 ， 比 较 方便 ，Custom 则 可 以 根 
据 用 户 的 特殊 需求 进行 自 定 义 。 简 单 起 见 ， 这 里 我 们 束 选 择 Standard 类 
型 了 ， 继 续 点 击 Next 完 成 配置 工作 ， 如 图 1.8 所 示 。 
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If you want to review or change any of your installation settings, click previous， 
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Previous | Next Cancel 
| 





图 1.8 完成 Android Studio 配 置 


现在 点 击 Finish 按 钮 ， 配 置 工作 束 全 部 完成 了 。 人 然后 Android Studio 会 尝 
试 联网 下 载 一 些 更 新 ， 等 待 更 新 完成 后 再 点 击 Finish 按 钮 就 会 进入 
Android Studio 的 欢迎 界面 ， 如 图 1.9 所 示 。 
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量 Check out project from Version Control v 


[¥ Import project (Eclipse ADT, Gradle, etc.) 


[¥ Import an Android code sample 





党 Configure x Get Helpv 





图 1.9 Android Studio 的 欢迎 界面 


目前 为 止 ，Android 开 发 环境 就 已 经 全 部 搭建 完成 了 。 那 现在 应 该 做 什 
么 ? 当然 是 写 下 你 的 第 一 行 Android 代 码 了 ， 让 我 们 快 点 开始 吧 。 





1.3 创建 你 的 第 一 个 Android 项 目 


任何 一 个 编程 语言 写 出 的 第 一 个 程序 坚 无 疑问 都 会 是 Hello World， 这 已 
经 是 目 20 世 纪 70 年 代 一 直流 传 下 来 的 传统 ， 在 编程 界 已 成 为 永恒 的 经 
典 ， 那 我 们 当然 也 不 会 搞 例 外 了 。 


1.3.1 创建 HelloWorld 项 目 





在 Android Studio 的 欢迎 界面 点 击 Start a new Android Studio project， 会 打 
开 一 个 创建 新 项 目的 界面 ， 如 图 1.10 所 示 。 


New Project 


人 Android Studio 


Configure your new project 


Application name: | HelloWorld 
Company Domain: | example.com 
Package name: com.example.helloworld 


口 Include C++ Support 


Project location: Ci\Users\Administrator\AndroidStudioProjects\HelloWorld 











图 1.10 创建 新 项 目 


其 中 Application name 表 示 应 用 名 称 ， 此 应 用 安装 到 手机 之 后 会 在 手机 上 
显示 该 名 称 ， 这 里 我 们 填 入 HelloWorld。Company ”Domain 表示 公司 域 
名 ， 如 果 是 个 人 开发 者 ， 没 有 公司 域名 的 话 ， 那 么 就 像 我 一 样 填 
example.com 就 可 以 了 。Package name 表 示 项 目的 包 名 ，Android 系 统 就 
是 通过 包 名 来 区 分 不 同 应 用 程序 的 ， 因 此 包 名 一 定 要 具有 唯一 性 。 





Android ， Studio 会 根据 应 用 名 称 和 公司 域名 来 自动 帮 有 我们 生成 合适 的 包 
名 ， 如 果 你 不 想 使 用 默认 生成 的 包 名 ， 也 可 以 点 击 右 侧 的 Edit 按 钮 自行 
修改 。 最 后 ，Project location 表示 项 目 代 码 存 放 的 位 置 ， 如 果 没 有 特殊 
要 求 的 话 ， 这 里 也 保持 默认 束 可 以 了 。 


接 下 来 点 击 Next 可 以 对 项 目的 最 低 兼 容 版 本 进行 设置 ， 如 图 1.11 所 示 。 





A Target Android Devices 


Select the form factors your app will run on 


Different platforms may require separate SDKs 


phone and Tablet 
Minimum SDK |API 15: Android 4.0.3 (IceCreamSandwich) 四 


Lower Api levels target more devices, but have fewer features available. 


By targeting API 15 and later your app will run on approximately 98.3% of the devices 
that are active on the Google Play Store. 


Help me choose Stats load failed. Value may be out of date. 
四 Wear 





Minimum SDK | ApI 21: Android 5.0 (Lollipop) 
Ow 


Minimum SDK |APpI 21: Android 5.0 (Lollipop) 





品 Android Auto 
s (Not Available) 


Minimum SDK 











图 1.11 设置 项 目的 最 低 兼 容 版 本 


前 面 已 经 说 过 ，Android 4.0 以 上 的 系统 已 经 占据 了 超过 98% 的 Android 市 
场 份 额 ， 因 此 这 里 我 们 将 Minimum SDK 指 定 成 API 15 就 可 以 了 。 另 外， 
Wear、TV 和 Android Auto 这 几 个 选项 分 别 是 用 于 开发 可 穿戴 设备 、 电 视 
和 汽车 程序 的 ， 目 前 这 几 个 领域 在 国内 还 没有 普及 ， 我 们 和 暂时 就 先 忽 略 
吧 。 接 着 点 击 Next 会 跳 转 到 创建 活动 界面 ， 这 里 我 们 可 以 选择 一 种 模 
板 ， 如 图 1.12 所 示 。 


下 Create New Proje 


XXX Add an Activity to Mobile 


Add No Activity 





Basic Activity 





Fullscreen Activity Google AdMob Ads Activity Google Maps Activity 


poion | 国史 对 cre | | rr 





图 1.12 选择 模板 

可 以 看 到 ，Android Studio 提 供 了 很 多 种 内 置 模板 ， 不 过 由 于 我 们 才刚 刚 
开始 学 习 ， 用 不 着 这 么 多 复杂 的 模板 ， 这 里 直接 选择 Empty Activity 来 创 
建 一 个 空 的 活动 就 可 以 了 。 


继续 点 击 Next， 可 以 给 创建 的 活动 和 布局 命名 ， 如 图 1.13 所 示 。 


Creates a new empty activity 


Activity Name: | HelloWorldActivity 
Generate Layout File 


Layout Name: | hello_world_layout 





Backwards Compatibility (AppCompat) 


The name of the layout to create for the activity 








previous | | Next | Cancel | Enish | 





图 1.13 给 活动 和 布局 命名 


其 中 ，Activity ”Name 表 示 活 动 的 名 字 ， 这 里 填 入 HelloWorldActivity， 
Layout ”Name 表示 布局 的 命名 ， 这 里 填 入 hello_world_layout。 然 后 点 击 
Finish 按 钮 ， 并 耐心 等 每 一 会 儿 ， 项 目 束 会 创建 成 功 了 ， 如 图 1.14 所 

人 外 o 
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图 1.14 项 目 创建 成 功 
1.3.2 ”启动 模拟 器 


由 于 Android Studio 上 自动 为 我 们 生成 了 很 多 东西 ， 你 现在 不 需要 编写 任何 
代码 ，HelloWorld 项 目 就 已 经 可 以 运行 了 。 但 是 在 此 之 前 还 必须 要 有 一 
个 运行 的 载体 ， 可 以 是 一 部 Android 手 机 ， 也 可 以 是 Android 模 拟 器 。 这 
里 我 们 暂时 先 使 用 模拟 喜来 运行 程序 ， 如 果 你 想 立 刻 就 将 程序 运行 到 手 
机 上 的 话 ， 可 以 参考 8.1 节 的 内 容 。 








那么 我 们 现在 就 来 创建 一 个 Android 模 拟 器 ， 观 察 Android Studio 顶部 工 
具 栏 中 的 图 标 ， 如 图 1.15 所 示 。 





[加 区 -再 有 a 
图 1.15 顶部 工具 栏 中 的 图 标 


其 中 ， 最 左边 的 按钮 就 是 用 于 创建 和 启动 模拟 器 的 ， 点 击 该 按钮 ， 会 弹 
出 如 图 1.16 所 示 的 窗口 。 


Your Virtual Devices 


| 口 一 


人 Androld Studio 


Virtual devices allow you to test your application without 
having to own the physical devices. 


十 Create Virtual Device... 


To prioritize which devices to test your application on, visit 
the Android Dashboards, where you can get up-to-date 
information on which devices are active in the Android and 
Google Play ecosystem. 





图 1.16 创建 模拟 器 


可 以 看 到 ， 目 前 我 们 的 模拟 器 列表 中 还 是 空 的 ， 点 击 Create Virtual 
Device 按 钮 就 可 以 立刻 开始 创建 了 ， 如 网 1.17 所 示 。 


Select Hardware 


Android Studio 











1080x1920 
768x1280 


Galaxy Nems 4.65" 720x1280 
| New Hardware profle | | Import Hardware Profiles | 








图 1.17 选择 要 创建 的 模拟 器 设备 


[DD Nexus 5X 


Sie: large 
Ratio long 
Density’ 420dpi 


ochdpi 
xhdpi 


xhdpi 





这 里 有 很 多 种 设备 可 供 我 们 选择 ， 不 仪 能 创建 手机 模拟 器 ， 还 可 以 创建 


平板 、 手 表 、 电 视 等 模拟 器 。 


那么 我 就 选择 创建 Nexus 5X 这 台 设 备 的 模拟 器 了 ， 点 击 Next， 如 图 1.18 


所 示 。 
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System Image 


Android Studio 





Ardreod 


5 7.0 

By i Google Inc. 
System Image 
x86 


These images are recommended because they run 
the fastest and include support for Google Apis 


Questions on API level? 
See the API level distribution chart 








图 1.18 ”选择 模拟 器 的 操作 系统 版 本 


这 里 可 以 选择 模拟 器 所 使 用 的 操作 系统 版 本 ， 训 无 疑问 ， 我 们 肯定 要 选 
择 最 新 的 Android 7.0 系 统 。 继 续 点 击 Next， 如 图 1.19 所 示 。 
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图 1.19 确认 模拟 器 配置 


在 这 里 我 们 可 以 对 模拟 器 的 一 些 配 置 进行 确认 ， 比 如 说 指定 模拟 器 的 名 
字 、 分 辩 率 、 横 竖 屏 等 信息 ， 如 果 没 有 特殊 需求 的 话 ， 全 部 保持 默认 就 
可 以 了 。 点 击 Finish 完 成 模拟 器 的 创建 ， 然 后 会 弹出 如 图 1.20 所 示 的 窗 
问 、 


Your Virtual Devices 


人 Android Studio 


_Type | Name |Resolution API | Target | CPU/ABI| Size on …| 
[HD] Nexu.. 1080.. 24 © Andr.. x86 650 .. 





十 Create Virtual Device... 


图 1.20 模拟 器 列表 


可 以 看 到 ， 现 在 模拟 器 列表 中 已 经 存在 一 个 创建 好 的 模拟 需 设 备 了 ， 点 
击 Actions 栏 目 中 最 左边 的 三 角形 按钮 即 可 局 动 模拟 器 。 模 拟 器 会 像 手 机 
一 样 ， 有 一 个 开机 过 程 ， 启 动 完成 之 后 的 界面 如 图 1.21 所 示 。 
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图 1.21 局 动 后 的 模拟 器 界面 

很 清新 的 Android 界 面 出 来 了 ! 看 上 去 还 挺 不 错 吧 ， 你 几乎 可 以 像 使 用 
手机 一 样 使 用 它 ，Android 模 拟 圳 对 手机 的 模仿 度 非 常 高 ， 快 去 体验 一 
下 吧 。 


1.3.3 ”运行 HellowWorld 


现在 模拟 器 已 经 启动 起 来 了 ， 那 么 下 面 我 们 就 开始 将 HelloWorld 项 目 运 
行 到 模拟 器 上 。 观 察 Android ”Studio 顶 部 工具 栏 中 的 图 标 ， 如 图 1.22 所 
示 。 其 中 左边 的 锤子 按钮 是 用 来 编译 项 上 目的， 中间 的 下 拉 列 表 是 用 来 选 
择 运 行 哪 一 个 项 目的 ， 通 常 app 就 是 当前 的 主 项 目 ， 右 边 的 三 角形 按钮 
是 用 来 运行 项 目的 。 
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图 1.22 顶部 工具 栏 中 的 图 标 


0 
1.23 所 不 。 








| 
网 Select Deployment Target 


Connected Devices 
Nexus 5X API 24 (Androld 7.0, API 24) 





| Create New Virtual Device Don't see your device? 





| 品 Use same selection for future launches 反击 | Ee | 





图 1.23 选择 运行 设备 对 话 框 
可 以 看 到 ， 我 们 刚刚 创建 的 模拟 器 现在 是 在 线 的 ， 点 击 OK 按 钮 ， 稍 微 


等 得 一 会 儿 ， HelloWorld 项 目 就 会 运行 到 模拟 器 上 上 了， 结果 应 该 和 图 
1.24 中 显示 的 是 一 样 的 。 


HelloWorld 








图 1.24 运行 HelloWorld 项 日 


HelloWorld 项 目 运 行 成 功 ! 并 且 你 会 发 现 ， 模 拟 器 上 已 经 安装 上 
HelloWorld 这 个 应 用 了 。 打 开启 动 嚣 列表， 如 图 1.25 所 示 。 
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图 1.25 查看 启动 器 列表 


这 个 时 候 你 可 能 会 说 我 坑 你 了 ， 说 好 的 第 一 行 代码 呢 ?” 怎 么 一 行 还 没 
写 ， 项 目 就 已 经 运行 起 来 了 ? 这 个 只 能 说 是 因为 Android ”Studio 太 智能 
了 ， 己 经 帮 我 们 把 一 些 简 单 内 容 都 自动 生成 了 。 你 也 别 心急 ， 后 面 写 代 
码 的 机 会 多 着 呢 ， 我 们 先 来 分 析 一 下 HelloWorld 这 个 项 目 吧 。 


1.3.4 ”分析 你 的 第 一 个 Android 程 序 


回 到 Android Studio 当 中 ， 首 先 展开 HelloWorld 项 目 ， 你 会 看 到 如 图 1.26 
所 示 的 项 目 结构 。 








慢 , Android Y 四 幸 | 振 ” 及 
C3app 
四 manifests 
四 java 
C3 res 
(5 Gradle Scripts 
(® build.gradle (Project: HelloWorld) 
全 build.gradle (Module: app) 
[al gradle-wrapper.properties (Gradle Version) 





目 proguard-rules.pro (ProGuard Rules for app) 
[al gradle.properties (Project Properties) 


(® settings.gradle (Project Settings) 





[i local.properties (SDK Location) 
图 1.26 Android 模式 的 项 目 结构 


任何 一 个 新 建 的 项 目 都 会 默认 使 用 Android 模 式 的 项 目 结构 ， 但 这 并 不 
是 项 目 真 实 的 目录 结构 ， 而 是 被 Android Studio 转 换 过 的 。 这 种 项 目 结构 
简洁 明了 ， 适 合 进 行 快 速 开 发 ， 但 是 对 于 新 手 来 说 可 能 并 不 易于 理解 。 
点 击 图 1.26 当 中 的 Android 区 域 可 以 切换 项 目 结构 模式 ， 如 图 1.27 所 示 。 
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图 1.27 切换 项 目 结构 模式 


这 里 我 们 将 项 目 结构 模式 切换 成 Project， 这 就 是 项 目 真 实 的 目录 结构 
了 ， 如 图 1.28 所 示 。 





晶 ] Project 了 四 去 | 举 - 有- 
Fz Helloworld CA a A istrator VAR roidstud 
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加 app 
四 build 
四 gradle 
目 .gitignore 
(® build.gradle 
而 gradle.properties 


目 gradlew 

目 gradlew.bat 

[& HelloWorld.iml 
[i local.properties 
(® settings.gradle 


图 1.28 ”Project 模 式 的 项 目 结构 
一 开始 看 到 这 么 多 陌生 的 东西 ， 你 一 定 会 感到 有 点 头晕 吧 。 别 担心 ， 我 


现在 就 对 图 1.28 中 的 内 容 进行 一 一 讲解 ， 之 后 你 再 看 这 张 图 就 不 会 感到 
那么 吃力 了 。 





1. .gradle 和 .idea 


这 两 个 目录 下 放置 的 都 是 Android Studio 自 动 生 成 的 一 些 文件 ， 我 们 
无 须 关 心 ， 也 不 要 去 手动 编辑 。 
2. app 


项 目 中 的 代码 、 资 源 等 内 容 几 乎 都 是 放置 在 这 个 目录 下 的 ， 我 们 后 
面 的 开发 工作 也 基本 都 是 在 这 个 目录 下 进行 的 ， 待 会 儿 还 会 对 这 个 
目录 单独 展开 进行 讲解 。 


3. build 


这 个 目录 你 也 不 需要 过 多 关心 ， 它 主要 包含 了 一 些 在 编译 时 自动 生 
成 的 文件 。 





10. 


. gradle 


这 个 目录 下 包含 了 gradle wrapper 的 配置 文件 ， 使 用 gradle wrapper 的 
方式 不 需要 提前 将 gradle 下 载 好 ， 而 是 会 目 动 根据 本 地 的 绥 存 情况 
决定 是 否 需 要 联网 下 载 gradle。Android 。 Studio 默认 没有 启用 gradle 
wrapper 的 方式 ， 如 果 需 要 打开 ， 可 以 点 击 Android ”Studio 导 航 栏 
File ~” Settings , Build，Execution，Deployment ~” Gradle， 进 行 配置 
更 改 。 








. .gitignore 





这 个 文件 是 用 来 将 指定 的 目录 或 文件 排除 在 版 本 控制 之 外 的 ， 关 于 
版 本 控制 我 们 将 在 第 5 章 中 开始 正式 的 学 习 。 





. build.gradle 





这 是 项 目 全 局 的 gradle 构 建 脚 本 ,通常 这 个 文件 中 的 内 容 是 不 需要 
修改 的 。 稍 后 我 们 将 会 详细 分 析 gradle 构 建 脚 本 中 的 具体 内 容 。 


. gradle.properties 





这 个 文件 是 全 局 的 gradle 配 置 文件 ， 在 这 里 配置 的 属性 将 会 影响 到 
项 目 中 所 有 的 gradle 编 译 脚 本 。 


. gradlew 和 lgradlew.bat 





这 两 个 文件 是 用 来 在 命令 行 界面 中 执行 gradle 命 令 的 ， 其 中 gradlew 
是 在 Linux 或 Mac 系 统 中 使 用 的 ，gradlew.bat 是 在 Windows 系 统 中 使 
用 的 。 


. HelloWorld.im!l 


iml 文 件 是 所 有 IntelliJ IDEA 项 目 都 会 自动 生成 的 一 个 文件 (Android 
Studio 是 基于 IntelliJ IDEA 开 发 的 ) ， 用 于 标识 这 是 一 个 IntelliJ 
IDEA 项 目 ， 我 们 不 需要 修改 这 个 文件 中 的 任何 内 容 。 


local.properties 


这 个 文件 用 于 指定 本 机 中 的 Android SDK 路 径 ， 通 常 内容 都 是 自动 





生成 的 ， 我 们 并 不 需要 修改 。 除 非 你 本 机 中 的 Android SDK 位 置 发 
生 了 变化 ， 那 么 就 将 这 个 文件 中 的 路 径 改 成 新 的 位 置 即 可 。 





11. settings.gradle 


这 个 文件 用 于 指定 项 目 中 所 有 引入 的 模块 。 由 于 HelloWorld 项 目 中 
束 只 有 一 个 app 模 块 ， 因 此 该 文件 中 也 就 只 引入 了 app 这 一 个 模块 。 
通常 情况 下 模块 的 引入 都 是 自动 完成 的 ， 需 要 我 们 手动 去 修改 这 个 
文件 的 场景 可 能 比较 少 。 


现在 整个 项 目的 外 层 目录 结构 已 经 介绍 完了 。 你 会 用 现 ， 除 了 app 目 录 
之 外 ， 大 多 数 的 文件 和 目录 都 是 目 动 生成 的 ， 我 们 并 不 需要 进行 修改 。 
想必 你 已 经 猜 到 了 ，app 目 录 下 的 内 容 才 是 我 们 以 后 的 工作 重点 ， 展 开 
之 后 结构 如 图 1.29 所 示 。 








四 app 
DD build 
亡 libs 
站 src 
思 androidTest 
DD main 
四 java 
C3 res 
荔 AndroidManifestxml 
四 test 
目 .gitignore 
app.iml 
全 build.gradle 


目 proguard-rules.pro 


图 1.29 ” app 目录 下 的 结构 
那么 下 面 我 们 就 来 对 app 目 录 下 的 内 容 进 行 更 为 详细 的 分 析 。 


1. build 


这 个 目录 和 外 层 的 build 目 录 类 似 ， 主 要 也 是 包含 了 一 些 在 编译 时 上 自 
动 生 成 的 文件 ， 不 过 它 里 面 的 内 容 会 更 多 更 杂 ， 我 们 不 需要 过 多 关 


心 Mo 
. libs 


如 果 你 的 项 目 中 使 用 到 了 第 三 方 jar 包 ， 就 需要 把 这 些 jar 包 都 放 在 
目录 下 ， 放 在 这 个 目录 下 的 jar 包 都 会 被 自动 添加 到 构建 路 径 里 





. androidTest 


此 处 是 用 来 编写 Android Test 测试 用 例 的 ， 可 以 对 项 目 进行 一 些 白 
动 化 测试 。 


. java 


量 无 疑问 ，java 目 录 是 放置 我 们 所 有 Java 代 码 的 地 方 ， 展 开 该 目 
录 ， 你 将 看 到 我 们 刚才 创建 的 HelloWorldActivity 文 件 就 在 里 面 。 





. es 





这 个 目录 下 的 内 容 就 有 点 多 了 。 简 单 点 说 ， 束 是 你 在 项 目 中 使 用 到 
的 所 有 图 片 、 布 局 、 字 符 串 等 资源 都 要 存放 在 这 个 目录 下 。 当 然 这 
个 目录 下 还 有 很 多 子 目 录 ， 图 片 放 在 drawable 目 录 下 ， 布 局 放 在 
layout 目 录 下 ， 字 符 串 放 在 values 目 录 下 ， 所 以 你 不 用 担心 会 把 整个 
res 目 录 弄 得 乱糟糟 的 。 











. AndroidManifest.xml 


这 是 你 整个 Android 项 目的 配置 文件 ， 你 在 程序 中 定义 的 所 有 四 大 
组 件 都 需要 在 这 个 文件 里 注册 ， 男 外 还 可 以 在 这 个 文件 中 给 应 用 程 
序 添加 权限 声明 。 由 于 这 个 文件 以 后 会 经 常用 到 ， 我 们 用 到 的 时 候 
再 做 详细 说 明 。 











. test 


此 处 是 用 来 编写 Unit Test 测 试用 例 的 ， 是 对 项 目 进行 目 动 化 测试 的 
为 一 种 六 式 。 


. .gitignore 


这 个 文件 用 于 将 app 模 块 内 的 指定 的 目录 或 文件 排除 在 版 本 控制 之 
外 ， 作 用 和 外 层 的 .gitignore 文 件 类 似 。 


9. app.iml 


Intelli] ”IDEA 项 目 自 动 生成 的 文件 ， 我 们 不 需要 关心 或 修改 这 个 文 
件 中 的 内 容 。 


10. build.gradle 


这 是 app 模 块 的 gradle 构 建 脚本 ， 这 个 文件 中 会 指定 很 多 项 目 构建 相 
天 的 配置 ， 我 们 稍 后 将 会 详细 分 析 gradle 构 建 脚本 中 的 具体 内 容 。 











11. proguard-rules.pro 


这 个 文件 用 于 指定 项 目 代 码 的 混 消 规 则 ， 当 代码 开发 完成 后 打 成 安 
装 包 文件 ， 如 宋 不 布 望 代码 被 别人 破解 ， 通 闻 会 将 代码 进行 混 消 ， 
从 而 让 破解 者 难以 阅读 。 
这 样 整个 项 目的 目录 结构 就 都 介绍 完了 ， 如 果 你 还 不 能 完全 理解 的 话 也 
很 正常 ， 毕 竟 里 面 有 太 多 的 东西 你 都 还 没 接触 过 。 不 过 不 用 担心 ， 这 并 
不 会 影响 到 你 后 面 的 学 习 。 等 你 学 完整 本 书 再 回来 看 这 个 目录 结构 图 
时 ， 你 会 觉得 特别 地 清晰 和 简单 。 


接 下 来 我 们 一 起 分 析 一 下 HelloWorld 项 目 究竟 是 怎么 运行 起 来 的 吧 。 首 
先 打开 AndroidManifest.xml 文 件 ， 从 中 可 以 找到 如 下 代码 : 


<activity android:name=".HelloworldActivity"> 
<in Fe 











android:name="android.intent.action.MAIN" /> 
ory android:name="android.intent.category.LAUNCHER" /> 
t 


这 段 代 人 码 表示 对 HelloWorldActivity 这 个 活动 进行 注册 ， 没 有 在 
AndroidManifest.xml 里 注册 的 活动 是 不 能 使 用 的 。 其 中 intent-filter 里 


的 两 行 代码 非常 重要 ，<action android:name= 
"android.intent.action.MAIN" /> 和 <category 
android:name="android.intent.category .LAUNCHER" /> 表示 


HelloWorldActivity 是 这 个 项 目的 主 活动 ， 在 手机 上 点 击 应 用 图 标 ， 首 先 
启动 的 就 是 这 个 活动 。 





那 HellowWorldActivity 具 体 又 有 什么 作用 呢 ? 我 在 介绍 Android 四 大 组 件 
的 时 候 说 过 ， 活 动 是 Android 应 用 程序 的 门面 ， 和 大 [是 在 应 用 中 你 看 得 到 
的 东西 ， 都 是 放 在 活动 中 的 。 因 此 你 在 图 1.24 中 看 到 的 界面 ， 其 实 就 是 
HelloWorldActivity 这 个 活动 。 那 我 们 快 去 看 一 下 它 的 代码 吧 ， 打 开 
HelloWorldActivity， 代 码 如 下 所 示 : 


public class HelloworldActivity extends AppCompatActivity { 





@override 

pro ate cte dy pid 0 ncreate(Bu avedInstanceState) { 
Upe Ce YedTns 全 Ke eta te 
et 5 ntw iew(R. a ayout.hello_wor rid _layout); 

} 


首先 我 们 可 以 看 到 ，HelloWorldActivity 是 继承 自 AppCompatActivity 

的 ， 这 是 一 种 回 下 兼容 的 Activity， 可 以 将 Activity 在 各 个 系统 版 本 中 增 
加 的 特性 和 功能 最 低 兼 容 到 Android 2.1 系 统 。Activity 是 Android 系 统 提 
供 的 一 个 活动 基 类 ， 我 们 项 目 中 所 有 的 活动 都 必须 继承 它 或 者 它 的 子 类 
才能 拥有 活动 的 特性 〈AppcompatActivity 是 Activity 的 子 类 ) 。 然 后 可 
以 看 到 HelloWorldActivity 中 有 一 个 oncreate() 方 法 ， 这 个 方法 是 一 个 活 
动 被 创建 时 必定 要 执行 的 方法 ， 其 中 只 有 两 行 代码 ， 并 且 没 有 Hello 
World! 的 字样 。 那 么 图 1.24 中 显示 的 Hello World! 是 在 哪里 定义 的 呢 ? 


其 实 Android 程 序 的 设计 讲究 逻辑 和 视图 分 离 ， 因 此 是 不 推荐 在 活动 中 
直接 编写 界面 的 ， 更 加 通用 的 一 种 做 法 是 ， 在 布局 文件 中 编写 界面 ， 然 
后 在 活动 中 引入 进来 。 可 以 看 到 ， 在 oncreate() 方 法 的 第 二 下 
setcontentView() 方 法 ， 就 是 这 个 方法 给 当前 的 活动 引入 了 一 
hello_world_layout 布 局 ， 那 Hello i 了 ! 我 们 
快 打开 这 个 文件 看 一 看 。 


布局 文件 都 是 定义 在 res/layout 目 录 下 的 ， 当 你 展开 layout 目 录 ， 你 会 看 
到 hello_world_layout.xml 这 个 文件 。 打 开 该 文件 并 切换 到 Text 视 图 ， 代 
人 码 如 下 所 示 : 




















<RelativeLayout xmlns:andro 3 ttp://schemas.android.com/apk/res/android" 
xmlns:tool ="http: A .android.com/tools" 
android:id="@+id/hello_w 1 = t 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:paddingBottom="@dime t ty_ve rtical margi 
android:paddingL a t ty_horizon tal_ margi 
android:paddingRi ght= "@dim /ac ty_h t a 的 
android:paddi ng SR den Enyat Vity_vertical_m 
tools:context="com ample ie owo 1d HelloworldActivity"> 
TextView 
ndroid:layout_width="wrap ntent" 
android:layout_hei oh wrap c content" 
android:text="Hello World!" /> 
/RelativeLayout> 


现在 还 看 不 懂 ? 没关系 ， 后 面 我 会 对 布局 进行 详细 讲解 的 ， 你 现在 只 需 
要 看 到 上 面 代 码 中 有 一 个 TextView， 这 是 Android 系 统 提 供 的 一 个 控 

件 ， 用 于 在 布局 中 显示 文字 的 。 然 后 你 终于 在 TextView 中 看 到 了 Hello 
World! 的 字样 ! 哈哈 ! 终于 找到 了 ， 原 来 束 是 通过 android:text="Hello 
World! "这 人 句 代 码 定义 的 o 


这 样 我 们 就 将 Helloworld 项 目的 目录 结构 以 及 基本 的 执行 过 程 都 分 析 完 
了 ， 相 信 你 对 Android 项 目 已 经 有 了 一 个 初步 的 认识 ， 下 一 小 市 中 我 们 
就 来 学 习 一 下 项 目 中 所 包含 的 资源 。 


1.3.5 ”详解 项 目 中 的 资源 


如 果 你 展开 res 目 录 看 一 下 ， 其 实 里 面 的 东西 还 是 挺 多 的 ， 很 容易 让 人 看 
得 眼花 综 乱 ， 如 图 1.30 所 示 。 


车 res 
加 drawable 
加 layout 
[ mipmap-hdpi 











© mipmap-mdpi 
加 mipmap-xhdpi 
后 mipmap-xxhdpi 
加 mipmap-xxcxhdpi 
[© values 

加 values-w820dp 


图 1.30 res 目录 下 的 结构 


看 到 这 么 多 的 文件 夹 也 不 用 害怕 ， 其 实 归 纳 一 下 ，res 目 录 束 变 得 非常 简 
单 了 。 所 有 以 drawable 开 头 的 文件 夹 都 是 用 来 放 图 片 的 ， 所 有 以 mipmap 
开头 的 文件 夹 都 是 用 来 放 应 用 图 标的 ， 所 有 以 values 开 头 的 文件 夹 都 是 
用 来 放 字 符 串 、 样 式 、 颜 色 等 配置 的 ，layout 文 件 夹 是 用 来 放 布 局 文件 
的 。 怎 么 样 ， 是 不 是 突然 感觉 清晰 了 很 多 ? 


之 所 以 有 这 么 多 mipmap 开 头 的 文件 严 ， 其 实 主要 是 为 了 让 程序 能 够 更 
好 地 兼容 各 种 设备 。drawable 文 件 夹 也 是 相同 的 道理 ， 虽 然 Android 





























Studio 没 有 帮 我 们 自动 生成 ， 但 是 我 们 应 该 自己 创建 drawable-hdpi、 
drawable-xhdpi、drawable-xxhdpi 等 文件 夹 。 在 制作 程序 的 时 候 最 好 能 够 
给 同一 张 图 片 提供 几 个 不 同 分辨 率 的 版 本 ， 分 别 放 在 这 些 文件 夹 下 ， 然 
后 当 程 序 运行 的 时 候 ， 会 自动 根据 当前 运行 设备 分 辨 紊 的 高 低 选择 加 载 
哪个 文件 夹 下 的 图 片 。 当 然 这 只 是 理想 情况 ， 更 多 的 时 候 美 工 只 会 提供 
0 一 份 图 片 ， 这 时 你 就 把 所 有 图 片 都 放 在 drawable-xxhdpi 文 件 夹 下 
承 好 本 


知道 了 res 目 录 下 每 个 文件 夹 的 含义 ， 我 们 再 来 看 一 下 如 何 去 使 用 这 些 资 
源 吧 。 打 开 res/ values/strings.xml 文 件 ， 内 容 如 下 所 示 : 


<resources> 
<string name="app_name">Helloworld</string> 














0 这 里 定义 了 一 个 应 用 程序 名 的 字符 串 ， 我 们 有 以 下 两 种 方式 
来 引用 它 。 





。 在 代码 中 通过 R. string.app_name 可 以 获得 该 字符 串 的 引用 。 
。 在 XML 中 通过 @string/app_name 可 以 获得 该 字符 串 的 引用 。 


基本 的 语法 就 是 上 面 这 两 种 方式 ， 其 中 string 部 分 是 可 以 替换 的 ， 如 果 
是 引用 的 图 片 资源 就 可 以 替换 成 drawable， 如 果 是 引用 的 应 用 图 标 就 可 
ee 如 果 是 引用 的 布局 文件 就 可 以 替换 成 layout， 以 此 类 


下 面 举 一 个 简单 的 例子 来 帮助 你 理解 ， 打 开 AndroidManifest.xml 文 件 ， 
找到 如 下 代码 : 





其 中 ，HelloWorld 项 目的 应 用 图 标 就 是 通过 android:icon 属 性 来 指定 
的 ， 应 用 的 和 名称 则 是 通过 android:1abel 属 性 指定 的 。 可 以 看 到 ， 这 里 
对 资源 引用 的 方式 正 是 我 们 刚刚 学 过 的 在 XML 中 引用 资源 的 语法 。 


经 过 本 小 市 的 学 习 ， 如 果 你 想 修 改 应 用 的 图 标 或 者 名 称 ， 相 信 已 经 知道 
该 怎么 办 了 吧 。 


1.3.6 ”详解 build.gradle 文 件 


不 同 于 Eclipse，Android Studio 是 采用 Gradle 来 构建 项 目的 。Gradle 是 一 
个 非常 先进 的 项 目 构 建 工具 ， 它 使 用 了 一 种 基于 Groovy 的 领域 特定 语言 
(DSL) 来 声明 项 目 设置 ， 据 弃 了 传统 基于 XML 〈 如 Ant 和 Maven) 的 

各 种 烦琐 配置 。 


在 1.3.4 小 节 中 我 们 已 经 看 到 ，HelloWorld 项 目 中 有 两 个 build.gradle 文 

件 ， 一 个 是 在 最 外 层 目 录 下 的 ， 一 个 是 在 app 目 录 下 的 。 这 两 个 文件 对 
构建 Android Studio 项 目 都 起 到 了 公关 重要 的 作用 ， 下 面 我 们 就 来 对 这 两 
个 文件 中 的 内 容 进 行 详细 的 分 析 。 


先 来 看 一 下 最 外 层 目 录 下 的 build.gradle 文 件 ， 代 码 如 下 所 示 : 




















d { 
classpath 'com.android.tools.build:gradle:2.2.0' 


这 些 代码 都 是 自动 生成 的 ， 虽 然 语 法 结构 看 上 去 可 能 有 点 难以 理解 ， 但 
是 如 末 我 们 忽略 语法 结构 ， 只 看 最 关键 的 部 分 ， 其 实 还 是 很 好 懂 的 。 


首先 ， 两 处 repositories 的 闭 包 中 都 声明 了 jcenter() 这 行 配 置 ， 那 么 这 
个 jcenter 是 什么 意思 呢 ? 其 实 它 是 一 个 代码 托管 仓库 ， 很 多 Android 开 源 
项 目 都 会 选择 将 代码 托管 到 jcenter 上， 声明 了 这 行 配 置 之 后 ， 我 们 就 可 
以 在 项 目 中 轻松 引用 任何 jcenter 上 的 开源 项 目 了 。 


接 下 来 ，dependencies 闭 包 中 使 用 classpath 声 明了 一 个 Gradle 插 件 。 为 
什么 要 声明 这 个 插件 呢 ? 因为 Gradle 并 不 是 专门 为 构建 Android 项 目 而 开 
发 的 ，Java、C++ 等 很 多 种 项 目 都 可 以 使 用 Gradle 来 构建 。 因 此 如 果 我 

们 要 想 使 用 它 来 构建 Android 项 目 ， 则 需要 声 

明 com.android.tools.build:gradle:2.2.0 这 个 插件 。 其 中 ， 最 后 面 的 











部 分 是 插件 的 版 本 写 ， 我 在 写作 本 书 时 最 新 的 插件 版 本 是 2.2.0。 
这 样 我 们 就 将 最 外 层 上 日 录 下 的 build.gradle 文 件 分 析 完 了 ， 通 常情 况 下 你 
0 的 内 容 ， 除 非 你 想 添 加 一 些 全 局 的 项 目 构 建 配 





下 面 我 们 再 来 看 一 下 app 目 录 下 的 build.gradle 文 件 ， 代 码 如 下 所 示 : 


apply plugin: "com.android.application' 


android 


release 
vad false 
proguardFiles getDefaultProguardFile('proguard-android.txt'), 
"proguard-rules.pro' 


} 


de ebeneies { 

mpile 二 ue SEre ee(dir bs neluder Dar 
ompile So id. uppo rt: appco mpa at - VI 
i StCompi ilie" "ju it:junit:4.12 


这 个 文件 中 的 内 容 束 要 相对 复杂 一 些 了 ， 下 面 我 们 一 行 行 地 进行 分 析 。 
首先 第 一 行 应 用 了 一 个 插件 ， 一 般 有 两 种 值 可 

选 : com.android.application 表 示 这 是 一 个 应 用 程序 模 

块 ，com.android.1ibrary 表 示 这 是 一 个 库 模块 。 应 用 程序 模块 和 库 模块 
的 最 大 区 别 在 于 ， es 云 行 的， 一 个 只 能 作为 代码 库 依 附 于 
别 的 应 用 程序 模块 来 运 


接 下 来 是 一 个 大 的 android 闭 包 ， 在 这 个 闭 包 中 我 们 可 以 配置 项 目 构 建 
的 各 种 属性 。 其 中 ，compilesdkversion 用 于 指定 项 目的 编译 版 本 ， 这 里 

站 定 成 24 表 示 使 用 Android 7.0 系 统 的 SDK 编 译 。buildToolsVersion 用 于 
指定 项 目 构 建 工 具 的 版 本 ， 目 前 最 新 的 版 本 就 是 24.0.2， 如 果 有 更 新 的 
版 本 时 ，Android Studio 会 进行 提示 。 


然后 我 们 看 到 ， 这 里 在 android 财 包 中 又 网 套 了 一 个 defaultConfig 闭 包 ， 
defaultConfig 闭 包 中 可 以 对 项 目的 更 多 细节 进行 配置 。 其 

中 ，applicationId 用 于 指定 项 目的 包 名 ， 前 面 我 们 在 创建 项 目的 时 候 
其 实 已 经 指定 过 包 名 了 ， 如 果 你 想 在 后 面 对 其 进行 修改 ， 那 么 就 是 在 这 

















里 修改 的 。minsdkversion 用 于 指定 项 目 最 低 兼 窑 的 Android 系 统 版 本 ， 

这 里 指定 成 15 表 示 最 低 兼 容 到 Android 4.0 系 统 。targetsdkversion 指 定 
的 值 表 示 你 在 该 目标 版 本 上 已 经 做 过 了 充分 的 测试 ， 系 统 将 会 为 你 的 应 
用 程序 启用 一 些 最 新 的 功能 和 特性 。 比 如 说 Android 6.0 系 统 中 引入 了 运 
行 时 权限 这 个 功能 ， 如 果 你 将 targetsdkversion 指 定 成 23 或 者 更 高 ， 那 
么 系统 束 会 为 你 的 程序 启用 运行 时 权限 功能 ， 而 如 果 你 

将 targetsdkversion 指 定 成 22， 那 么 就 说 明 你 的 程序 最 高 只 在 Android 
5.1 系 统 上 做 过 充分 的 测试 ，Android 6.0 系 统 中 引入 的 新 功能 自然 就 不 会 
启用 了 。 剩 下 的 两 个 属性 都 比较 简单 ，versioncode 用 于 指定 项 目的 版 
本 号 ，versionName 用 于 指定 项 目的 版 本 名 ， 这 两 个 属性 在 生成 安装 文 
件 的 时 候 非 常 重 要 ， 我 们 在 后 面 都 会 学 到 。 


分 析 完 了 defaultConfig 闭 包 ， 接 下 来 我 们 看 一 下 buildTypes 闭 包 。 
buildTypes 闭 包 中 用 于 指定 生成 安装 文件 的 相关 配置 ， 通 常 只 会 有 两 个 
子 闭 包 ， 一 个 是 debug， 一 个 是 release。debug 闭 包 用 于 指定 生成 测试 版 
安装 文件 的 配置 ，release 闭 包 用 于 指定 生成 正式 版 安装 文件 的 配置 。 男 
外 ，debug 闭 包 是 可 以 忽略 不 写 的 ， 因 此 我 们 看 到 上 面 的 代码 中 就 只 有 
一 个 release 闭 包 。 下 面 来 看 一 下 release 闭 包 中 的 具体 内 容 

吧 ，mjinifyEnabled 用 于 指定 是 否 对 项 目的 代码 进行 混 请 ，true 表 示 混 
消 ，false 表 示 不 混 消 。proguardFiles 用 于 指定 混淆 时 使 用 的 规则 文 
件 ， 这 里 指定 了 两 个 文件 ， 第 一 个 proguard-android.txt 是 在 Android 
SDK 目 录 下 的 ， 里 面 是 所 有 项 目 通 用 的 混淆 规则 ， 第 二 个 proguard- 
rules.pro 是 在 当前 项 目的 根 目 录 下 的 ， 里 面 可 以 编写 当前 项 目 特 有 的 
混淆 规则 。 需 要 注意 的 是 ， 通 过 Android Studio 直 接 运 行 项 目 生 成 的 都 是 
则 试 版 安装 文件 ， 关 于 如 何 生成 正式 版 安装 文件 我 们 将 会 在 第 15 章 中 学 
































计 
习 。 


这 样 整 个 android 财 包 中 的 内 容 就 都 分 析 完 了 ， 接 下 来 还 剩 一 个 
dependencies 财 包 。 这 个 闭 包 的 功能 非常 强大 ， 它 可 以 指定 当前 项 目 所 
有 的 依赖 关系 。 通 常 Android ”Studio 项 目 一 共有 3 种 依赖 方式 : 本 地 依 
赖 、 库 依赖 和 远程 依赖 。 本 地 依赖 可 以 对 本 地 的 Jar 包 或 目录 添加 依赖 关 
系 ， 库 依赖 可 以 对 项 目 中 的 库 模块 添加 依赖 关系 ， 远 程 依赖 则 可 以 对 
jcenter 库 上 的 开源 项 目 添加 依赖 关系 。 观 察 一 下 dependencies 闭 包 中 的 配 
置 ， 第 一 行 的 compile fileTree 就 是 一 个 本 地 依赖 声明 ， 它 表示 将 libs 日 
录 下 所 有 .jar 后 级 的 文件 都 添加 到 项 目的 构建 路 径 当 中 。 而 第 二 行 的 
compile 则 是 远程 依赖 声明 ，com.android.support:appcompat-v7:24.2.1 
就 是 一 个 标准 的 远程 依赖 库 格 式 ， 其 中 com.android.support 是 域名 部 





分 ， 用 于 和 其 他 公司 的 库 做 区 分 ;1 appcompat-v7 是 组 名 称 ， 用 于 和 同一 
个 公司 中 不 同 的 库 做 区 分 ，24.2.1 是 版 本 号 ， 用 于 和 同一 个 库 不 同 的 版 
本 做 区 分 。 加 上 这 和 句 声 明 后 ，Gradle 在 构建 项 目 时 会 首先 检查 一 下 本 地 
是 否 已 经 有 这 个 库 的 缓存 ， 如 果 没 有 的 话 则 会 去 自动 联网 下 载 ， 然 后 再 
添加 到 项 目的 构建 路 径 当 中 。 人 至 于 库 依 赖 声 明 这 里 没有 用 到 ， 它 的 基本 
格式 是 compile project 后 面 加 上 要 依赖 的 库 名 称 ， 比 如 说 有 一 个 库 模块 
的 名 字 叫 helper， 那 么 添加 这 个 库 的 依赖 关系 只 需要 加 入 compile 

project(':helper') 这 人 句 声 明 即 可 。 另 外 剩 下 的 一 名 testcompile 是 用 于 
声明 测试 用 例 库 的 ， 这 个 我 们 暂时 用 不 到 ， 先 忽略 它 就 可 以 了 。 

















1.4 ”前 行 必 备 一 一 掌握 日 志 工 上 其 的 使 
用 


通过 上 一 节 的 学 习 ， 你 已 经 成 功 创建 了 你 的 第 一 个 Android 程 序 ， 并 且 

对 Android 项 目的 目录 结构 和 运行 流程 都 有 了 一 定 的 了 解 。 现 在 本 应 该 

是 你 继续 前 行 的 时 候 ， 不 过 我 想 在 这 里 给 你 穿插 一 点 内 容 ， 讲 解 一 下 

0 
和 帮助 。 


1.4.1 使 用 Android 的 日 志 工 具 Log 


Android 中 的 日 志 工 具 类 是 Log (android.util.Log) ， 这 个 类 中 提供 了 如 
下 5 个 方法 来 供 我 们 打印 日 志 。 





e。Log.v()。 用 于 打印 那些 最 为 琐碎 的 、 意 义 最 小 的 日 志 人 信息。 对 应 
级 别 verbose， 是 Android 日 志 里 面 级 别 最 低 的 一 种 。 


。 Log.d()。 用 于 打印 一 些 调试 信息 ， 这 些 信息 对 你 调试 程序 和 分 析 
问题 应 该 是 有 帮助 的 。 对 应 级 别 debug， 比 verbose 高 一 级 。 


Log.i()。 用 于 打印 一 些 比较 重要 的 数据 ， 这 些 数 据 应 该 是 你 非常 
想 看 到 的 、 可 以 帮 你 分 析 用 户 行为 数据 。 对 应 级 别 info， 比 debug 高 


Log.w()。 用 于 打印 一 些 警 告 信息 ， 提 示 程 序 在 这 个 地 方 可 能 会 有 
潜在 的 风险 ， 最 好 去 修复 一 下 这 些 出 现 警 告 的 地 方 。 对 应 级 别 


warn， 比 info 高 一 级 。 


Log.e()。 用 于 打印 程序 中 的 错误 信息 ， 比 如 程序 进入 到 了 catch 语 
名 当中 。 当 有 错误 信息 打印 出 来 的 时 候 ， 一 般 都 代表 你 的 程序 出 现 
严重 问题 了 ， 必 须 尽 快 修 复 。 对 应 级 别 error， 比 warn 高 一 级 。 


其 实 很 简单 ， 一 共 就 5 个 方法 ， 当 然 每 个 方法 还 会 有 不 同 的 重 载 ， 但 那 
对 你 来 说 肯定 不 是 什么 难 理解 的 地 方 了 。 我 们 现在 就 在 HelloWorld 项 目 





























中 试 一 试 日 志 工 具 好 不 好 用 吧 。 


打开 HellowWorldActivity， 在 oncreate() 方 法 中 添加 一 行 打印 日 志 的 语 


protected void onCreate(Bundle sav ee { 
super .onCreate( sav' Sun ne ee te); 
setContentView(R.1layout.hello_ world_layout); 
Log.d("HelloworldActi Wt "onCreate execute"); 





Log.d() 方 法 中 传 入 了 两 个 参数 : 第 一 个 参数 是 tag， 一 般 传 入 当前 的 类 
名 就 好 ， 主 要 用 于 对 打印 信息 进行 过 小; 第 二 个 参数 是 nsg， 即 想 要 打 
印 的 具体 的 内 容 。 


现在 可 以 重新 运行 一 下 HelloWorld 这 个 项 目 了 ， 点 击 顶部 工具 栏 上 的 运 

行 按 钮 ， 或 者 使 用 快捷 键 Shift + F10 (Mac 系 统 是 control + R) ， 等 程序 
运行 完毕 ， 点 击 Android Studio 底 部 工具 栏 的 Android Monitor， 在 logcat 
中 就 可 以 看 到 打印 信息 了 ， 如 图 1.31 所 示 。 


Android Monitor 次 志 
鹿 Emulator Nexus_5X_API 24 上 图 com.example.helloworld 日 

加 | ix logcat | Monitors »" Verbose "| QronCreate Regex | Show only selected application 图 

园 会 ”09-27 14:21:13.949 3253-~3253/com. example. helloworld D/HelloWorldActivity: onCreate execute 

-图 

人 
. 

@ | ， 

?| 如 

六 4kun TODO DGAndroid Monitor 国 0:Messages 国 Terminal 辕 3 Event Log 国 Gradle Console 





图 1.31 logcat 中 的 打印 信息 


其 中 ， 你 不 仅 可 以 看 到 打印 日 志 的 内 容 和 tag 名 ， 束 连 程序 的 包 名 、 打 
印 的 时 间 以 及 应 用 程序 的 进程 号 都 可 以 看 到 。 


另外 ， 不 知道 你 有 没有 注意 到 ， 你 的 第 一 行 代码 已 经 在 不 知 不 党 中 写 出 
来 了 ， 我 也 总 算是 交差 了 。 


1.4.2 ”为 什么 使 用 Log 而 不 使 用 System.out 

















我 相信 很 多 的 Java 新 手 都 非 芝 喜欢 使 用 System.out .println() 方 法 来 打 
印 日 志 ， 不 知道 你 是 不 是 也 喜欢 这 么 做 。 不 过 在 真正 的 项 目 开 发 中 ， 是 
极度 不 建议 使 用 System.out.println() 方 法 的 ! 如 果 你 在 公司 的 项 目 中 
经 党 使 用 这 个 方法 ， 就 很 有 可 能 要 挨 骂 了 。 


为 什么 system.out .println() 方 法 会 这 么 遭 大 家 唾弃 呢 ? 经 过 我 仔细 分 
析 之 后 ， 发 现 这 个 方法 除了 使 用 方便 一 点 之 外 ， 其 他 就 一 无 是 处 了 。 方 
便 在 哪儿 呢 ? 在 Eclipse 中 你 只 需要 输入 syso， 然 后 按 下 代码 提示 键 ， 这 
个 方法 就 会 自动 出 来 了 ， 相 信 这 也 是 很 多 Java 新 手 对 它 钟 情 的 原因 。 那 
缺点 又 在 哪儿 了 呢 ? 这 个 就 太 多 了 ， 比 如 日 志 打 印 不 可 控制 、 打 印 时 间 
无 法 确定 、 不 能 添加 过 滤器 、 日 志 没 有 级 别 区 分 .……. 


听 我 说 了 这 些 ， 你 可 能 已 经 不 太 想 用 System.out .println() 方 法 了 ， 那 

么 Log 束 把 上 面 所 说 的 缺点 全 部 都 改 好 了 吗 ? 虽然 谈 不 上 全 部 ， 但 我 觉 

入 Log 经 得 相 当 不 错 了 。 我 现在 训 来 将 你 看 看 Logfiiogea 本 全 的 
之 烛 


首先 刚才 提 到 的 快捷 输入 ， 在 Android Studio 当 中 也 是 有 的 ， 比 如 你 想 打 
印 一 条 debug 级 别 的 日 志 ， 那 么 只 需要 输入 logd， 然 后 按 下 Tab 键 ， 束 会 
帮 你 目 动 补 全 一 条 完整 的 打印 语句 。 输 入 logi， 然 后 按 下 Tab 键 ， 会 目 动 
补 全 一 条 info 级 别 的 打印 日 志 。 输 入 logw， 按 下 Tab 键 ， 会 自动 补 全 一 条 
warn 级 别 的 打印 日 志 ， 以 此 类 推 。 男 外 ， 由 于 Log 的 所 有 打印 方法 都 要 
求 传 入 一 个 tag 参 数 ， 每 次 写 一 过 显然 太 过 麻烦 。 这 里 还 有 一 个 小 技 

巧 ， 我 们 在 oncreate() 方 法 的 外 面 输入 logt， 然 后 按 下 Tab 键 ， 这 时 就 会 
以 当前 的 类 名 作为 值 自动 生成 一 个 TAG 常 量 ， 如 下 所 示 : 


public class HelloworldActivity extends AppCompatActivity { 



































private static final String TAG = "HelloworldActivity"; 


ji 


除了 快捷 得 入 之 外 ，logcat 中 还 能 很 轻松 地 添加 过 涯 器 ， 你 可 以 在 图 1.32 
中 看 到 我 们 目前 所 有 的 过 滤器 。 


Show only selected application 攻 。 


Show only selected application 


Firebase 
No Filters 
Edit Filter Configuration 





图 1.32 logcat 中 的 过 滤器 


目前 只 有 3 个 过 滤器 ，Show only selected application 表 示 只 显示 当前 选中 
程序 的 日 志 ， Firebase 是 谷歌 提供 的 一 个 分 析 工 具 ， 我 们 可 以 不 用 管 
它 ，No Filters 相 当 于 没有 过 滤器 ， 会 把 所 有 的 日 志 都 显示 出 来 。 那 可 不 
可 以 自 定义 过 滤器 呢 ?” 当 然 可 以 ， 我 们 现在 就 来 添加 一 个 过 滤器 试 试 。 


点 击 图 1.32 中 的 Edit Filter Configuration， 会 弹出 一 个 过 滤器 配置 界面 。 
0 0 过 滤 ， 如 图 
1.33 所 不 





二 
网 Create New Logcat Filter 





十 一 Filter Name: | data 


Specify one or several filtering parameters: 


:AT 
Log Tag: IQr data ) Regex 
Log Message: @- 光 Regex 











Package Name: |IQ- ) Regex 


PID: 


Log Level: | Verbose 加 


[en| | Cancel | 














图 1.33 过 滤器 配置 界面 


点 击 OK， 你 就 会 发 现 你 已 经 多 出 了 一 个 data 过 滤器 。 当 你 点 击 这 个 过 渡 
器 的 时 候 ， 你 会 Ee ed 没 了 ， 这 是 因 
为 data 这 个 过 滤器 只 会 显示 tag 名 称 为 data 的 日 志 。 你 可 以 尝试 

在 oncreate() 方 法 中 把 打印 日 志 的 i 看 句 改 成 Log. te "onCreate 














execute"), 然后 再 次 运行 程序 ， 你 就 会 在 data 过 滤器 下 看 到 这 行 日 志 
本 








不 知道 你 有 没有 体会 到 使 用 过 滤器 的 好 处 ， 可 能 现在 还 没有 吧 。 不 过 当 
你 的 程序 打印 出 成 百 上 千 行 日 志 的 时 候 ， 你 就 会 迫切 地 需要 过 滤器 了 。 


看 完了 过 小 名 ， 再 来 看 一 下 logcat 中 的 日 志 级 别 控制 吧 。logcat 中 主要 有 
5 个 级 别 ， 分 别 对 应 着 上 一 市 介绍 的 5 个 方法 ， 如 图 1.34 所 示 。 








图 1.34 logcat 中 的 日 志 级 别 


当前 我 们 选中 的 级 别 是 verbose， 也 就 是 最 低 等 级 。 这 意味 着 不 管 我 们 使 
用 哪 一 个 方法 打印 日 志 ， 这 条 日 志 都 一 定 会 显示 出 来 。 而 如 果 我 们 将 级 
别 选中 为 debug， 这 时 只 有 我 们 使 用 debug 及 以 上 级 别 方法 打印 的 日 志 才 
会 显示 出 来 ， 以 此 类 推 。 你 可 以 做 一 下 试验 ， 当 你 把 logcat 中 的 级 别 选 
中 为 info、warn 或 者 error 时 ， 我 们 在 oncreate() 方 法 中 打印 的 语句 是 不 
会 显示 的 ， 因 为 我 们 打印 日 志 时 使 用 的 是 Log.d() 方 法 。 


日 志 级 别 控制 的 好 处 残 是 ， 你 可 以 很 快 地 找到 你 所 关心 的 那些 日 志 。 相 
信和 如果 让 你 从 上 干 行 日 志 中 查找 一 条 朋 尝 信息 ， 你 一 定 会 抓 狂 的 吧 。 而 
现在 你 只 需要 将 日 志 级 别 选 中 为 error， 那 些 不 相干 的 琐碎 信息 就 不 会 再 
干扰 你 的 视线 了 。 


最 后 我 们 再 来 看 一 下 关键 字 过 滤 。 如 果 使 用 过 滤器 加 日 志 级 别 控制 还 是 
不 能 锁定 到 你 想 查看 的 日 志 内 容 的 话 ， 那 么 还 可 以 通过 关键 字 进 行进 一 
步 的 过 滤 ， 如 图 1.35 所 示 。 











Q- onCreate ) Regex 





图 1.35 ”关键 字 输 入 框 


我 们 可 以 在 输入 框 里 输入 关键 字 的 内 容 ， 这 样 只 有 符合 关键 字条 件 的 日 
志 才 会 显示 出 来 ， 从 而 能 够 快速 定位 到 任何 你 想 查 看 的 日 志 。 男 外 还 有 
一 点 需要 注意 ， 关 键 字 过 滤 是 支持 正则 表达 式 的 ， 有 了 这 个 特性 ， 我 们 
就 可 以 构建 出 更 加 丰富 的 过 滤 条 件 。 


关于 Android 中 日 志 工 具 的 使 用 我 就 准备 讲 到 这 里 ，logcat 中 其 他 的 一 些 
使 用 技巧 融 要 靠 你 目 己 去 摸索 。 今 天 你 已 经 学 到 了 足够 多 的 东西 ， 我 
们 来 总 结 和 梳理 一 下 吧 。 








1.5 小 结 与 点 评 


你 现在 一 定 会 觉得 很 充实 ， 甚 至 有 点 沾沾自喜 。 确 实 应 该 如 此 ， 因 为 你 
己 经 成 为 一 名 真正 的 Android 开 发 者 了 。 通 过 本 章 的 学 习 ， 你 首先 对 
Android 系 统 有 了 更 加 充足 的 认识 ， 然 后 成 功 将 Android 开 发 环境 搭建 了 
起 来 ， 接 着 创建 了 你 自己 的 第 一 个 Android 项 目 ， 并 对 Android 项 目的 目 
录 结 构 和 执行 过 程 有 了 一 定 的 认识 ， 在 本 章 的 最 后 还 学 习 了 Android 日 
志 工 具 的 使 用 ， 这 难道 还 不 够 充实 吗 ? 


不 过 你 也 别 太 过 于 满足 ， 相 信 你 很 清楚 ，Android 开 发 者 和 出 色 的 

Android 开 发 者 还 是 有 很 大 的 区 别 的 ， 你 还 需要 付出 更 多 的 努力 才 行 。 
即使 你 目前 在 Java 领 域 已 经 有 了 不 错 的 成 绩 ， 我 也 希望 在 Android 的 世界 

以 一 只 萌 级 小 染 乌 的 里 份 起 飞 ， 在 后 面 的 旅途 中 你 会 
\ 断 地 成 长 。 


现在 你 可 以 非常 安心 地 休 恳 一段 时 间 ， 因 为 今天 你 已 经 做 得 非常 不 错 
了 。 储 备 好 能 量 ， 准 备 进 入 到 下 一 音 的 旅程 当中 。 
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入 大 < 4 旦 分 六 
第 2 章 先 从 看 得 到 的 入 手 一 探 宛 
活动 

通过 上 一 章 的 学 习 ， 你 已 经 成 功 创建 了 你 的 第 一 个 Android 项 目 。 不 过 
仅仅 满足 于 此 显然 是 不 够 的 ， 是 时 候 学 点 新 的 东西 了 。 作 为 你 的 导师 ， 
我 有 义务 帮 你 制定 好 后 面 的 学 习 路 线 ， 那 么 今天 我 们 应 该 从 哪儿 入 手 
呢 ? 现在 你 可 以 想象 一 下 ， 假 如 你 已 经 写 出 了 一 个 非常 优秀 的 应 用 程 
序 ， 然 后 推荐 给 你 的 第 一 个 用 户 ， 你 会 从 哪里 开始 介绍 呢 ? 毫 无 疑问 ， 
当然 是 从 界面 开始 介绍 了 ! 因为 即使 你 的 程序 算法 再 高 效 ， 架 构 再 出 
色 ， 用 户 根本 不 会 在 乎 这 些 ， 他 们 一 开始 只 会 对 看 得 到 的 东西 感 兴趣 ， 
那么 我 们 今天 的 主题 自然 也 要 从 看 得 到 的 入 手 了 。 














2.1 活动 是 什么 


活动 (Activity〉 是 最 容易 吸引 用 户 的 地 方 ， 它 是 一 种 可 以 包含 用 户 界 
面 的 组 件 ， 主 要 用 于 和 用 户 进 行 交 互 。 一 个 应 用 程序 中 可 以 包含 零 个 或 
多 个 活动 ， 但 不 包含 任何 活动 的 应 用 程序 很 少见 ， 谁 也 不 想 让 自己 的 应 
用 永远 无 法 被 用 户 看 到 吧 ? 


其 实在 上 一 章 中 ， 你 已 经 和 活动 打 过 交道 了 ， 并 且 对 活动 也 有 了 初步 的 
认识 。 不 过 上 一 章 我 们 的 重点 是 创建 你 的 第 一 个 Android 项 目 ， 对 活动 
的 介绍 并 不 多 ， 在 本 章 中 我 将 对 活动 进行 详细 的 介绍 。 








2.2 活动 的 基本 用 法 


到 现在 为 止 ， 你 还 没有 手动 创建 过 活动 呢 ， 因 为 上 一 章 中 的 
HelloWorldActivity 是 Android ”Studio 帮 我 们 自动 创建 的 。 手 动 创 建 活动 
可 以 加 深 我 们 的 理解 ， 因 此 现在 是 时 候 应 该 自己 动手 了 。 


由 于 Android Studio 在 一 个 工作 区 间 内 只 允许 打开 一 个 项 目 ， 因 此 首先 你 

要 将 当前 的 项 目 关 闭 ， 点 击 导 航 栏 File ~ Close Project。 然 后 再 新 建 一 
个 Android 项 目 ， 项 目 名 可 以 叫 作 ActivityTest， 包 名 我 们 就 使 用 默认 值 
com.example.activitytest。 新 建 项 目的 步骤 你 已 经 在 上 一 章 学 习 过 了 ， 不 
过 图 1.12 中 的 那 一 步 需要 稍 做 修改 ， 我 们 不 再 选择 Empty Activity 这 个 选 
项 ， 而 是 选择 Add No Activity， 因 为 这 次 我 们 准备 手动 创建 活动 ， 如 图 
2.1 所 示 。 
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图 2.1 选择 不 添加 活动 
点 击 Finish， 等 待 Gradle 构 建 完 成 后 ， 项 目 就 创建 成 功 了 。 
2.2.1 手动 创建 活动 


项 目 创建 成 功 后 ， 仍 然 会 默认 使 用 Android 模 式 的 项 目 结构 ， 这 里 我 们 
手动 改 成 Project 模 式 ， 本 书 中 后 面 的 所 有 项 目 都 要 这 样 修改 ， 以 后 就 不 
再 闹 述 了 。 目 前 ActivityTest 项 目 中 虽然 还 是 会 自动 生成 很 多 文件 ， 但 是 
app/src/main/java/com.example.activitytest 目 录 应 该 是 空 的 了 ， 如 图 2.2 所 
示 。 
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图 2.2 初始 项 目 结构 


现在 右 击 com.example.activitytest 包 ~ New-，ActivityEmpty Activity， 
会 弹出 一 个 创建 活动 的 对 话 框 ， 我 们 将 活动 命名 为 FirstActivity， 并 且 不 
要 勾 选 Generate Layout File 和 Launcher Activity 这 两 个 选项 ， 如 图 2.3 所 
人 外 o 
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图 2.3 新 建 活动 对 话 框 


勾 选 Generate Layout File 表 示 会 自动 为 FirstActivity 创 建 一 个 对 应 的 布局 
文件 ， 勾 选 Launcher _ Activity 表示 会 目 动 将 FirstActivity 设 置 为 当前 项 目 
的 主 活动 ， 这 里 由 于 你 是 第 一 次 手动 创建 活动 ， 这 些 自 动 生成 的 东西 暂 
时 都 不 要 义 选 ， 下 面 我 们 将 会 一 个 个 手动 来 完成 。 义 选 Backwards 
Compatibility 表 示 会 为 项 目 启用 向 下 兼容 的 模式 ， 这 个 选项 要 勾 上 。 点 
击 Finish 完 成 创建 。 

你 需要 知道 ， 项 目 中 的 任何 活动 都 应 该 重 写 Activity 的 oncreate() 方 法 ， 


而 目前 我 们 的 FirstActivity 中 已 经 重 写 了 这 个 方法 ， 这 是 由 Android 
Studio 目 动 帮 我 们 完成 的 ， 代 码 如 下 所 示 : 











public class FirstActivity extends AppCompatActivity { 


@override 
protected void onCreate(Bundle SavedInstanceState) { 
Super .onCcreate(SavedInstanceState) 


} 


可 以 看 到 ，oncreate() 方 法 非常 简单 ， 就 是 调用 了 父 类 的 oncreate() 方 
法 。 当 然 这 只 是 默认 的 实现 ， 后 面 我 们 还 需要 在 里 面 加 入 很 多 目 己 的 逻 
0 


2.2.2 ”创建 和 加 载 布局 


前 面 我 们 说 过 ，Android 程 序 的 设计 讲究 逻辑 和 视图 分 离 ， 最 好 每 一 个 
活动 都 能 对 应 一 个 布局 ， 布 局 就 是 用 来 显示 界面 内 容 的， 因此 我 们 现在 
就 来 手动 创建 一 个 布局 文件 。 


右 击 app/src/main/res 目 录 -New Directory， 会 弹出 一 个 新 建 日 录 的 窗 
口 ， 这 里 先 创建 一 个 名 为 layout 的 目录 。 然 后 对 着 layout 目 录 右 键 

一 New Layout resource file， 又 会 弹出 一 个 新 建 布 局 资源 文件 的 窗口 ， 
我 们 将 这 个 布局 文件 命名 为 first_layout， 根 元 素 就 默认 选择 为 
LinearLayout， 如 图 2.4 所 示 。 
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图 2.4 新 建 布局 资源 文件 
扩 击 OK 完成 布局 的 创建 ， 这 时 候 你 会 看 到 如 图 2.5 所 示 的 布局 编辑 器 。 
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图 2.5 布局 编辑 器 


这 是 Android Studio 为 我 们 提供 的 可 视 化 布局 编辑 器 ， 你 可 以 在 屏 右 的 中 
央 区 域 预览 当前 的 布局 。 在 窗口 的 最 下 方 有 两 个 切换 卡 ， 左 边 是 
Design， 右 边 是 Text。Design 是 当前 的 可 视 化 布局 编辑 器 ， 在 这 里 你 不 
仅 可 以 预览 当前 的 布局 ， 还 可 以 通过 拖 放 的 方式 编辑 布局 。 而 Text 则 是 
的 方式 来 编辑 布局 的 ， 现 在 点 击 一 下 Text 切 换 卡 ， 可 以 看 
| 如 下 代码 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 

















</LinearLayout> 





由 于 我 们 刚才 在 创建 布局 文件 时 选择 了 LinearLayout 作 为 根 元 素 ， 因 此 
现在 布局 文件 中 己 经 有 一 个 LinearLayout 元 素 了 。 那 我 们 现在 对 这 个 布 
局 稍 做 编辑 ， 添 加 一 个 按钮 ， 如 下 所 示 : 





<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<Button 
android:id="@+id/button_1" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Button 1" 


</LinearLayout> 


这 里 添加 了 一 个 Button 元 素 ， 并 在 Button 元 素 的 内 部 增加 了 几 个 必 

性 。android:id 是 给 当前 的 元 素 定 义 一 个 唯一 标识 符 ， 之 后 可 以 在 代码 
中 对 这 个 元 素 进 行 操作 。 你 可 能 会 对 @+id/ ”button_1 这 种 语法 感到 陌 
生 ， 但 如 果 把 加 号 去 掉 ， 变 成 eid/button_ 1， 这 样 你 就 会 觉得 有 些 熟悉 
了 吧 ， 这 不 就 是 在 XML 中 引用 资源 的 语法 吗 ? 只 不 过 是 把 string 蔡 换 成 
了 id。 是 的 ， 如 果 你 需要 在 XML 中 引用 一 个 id， 就 使 用 eid/id_name 这 
种 语法 ， 而 如 果 你 需要 在 XML 中 定义 一 个 id， 则 要 使 用 e+id/id_name 这 
种 语法 。 随 后 android:1layout_width 指 定 了 当前 元 素 的 宽度 ， 这 里 使 
用 match_parent 表 示 让 当前 元 素 和 父 元 素 一 样 

宽 。android:layout_height 指 定 了 当前 元 素 的 高 度 ， 这 里 使 

用 wrap_content 表 示 当 前 元 素 的 高 度 只 要 能 刚好 包含 里 面 的 内 容 就 

行 。android:text 指 定 了 元 素 中 显示 的 文字 内 容 。 如 果 你 还 不 能 完全 看 
明白 ， 没 有 关系 ， 关 于 编写 布局 的 详细 内 容 我 会 在 下 一 章 中 重点 讲解 ， 
本 章 只 是 先 简 单 涉及 一 些 。 现 在 按钮 已 经 添加 完了 ， 你 可 以 通过 右 侧 工 
县 栏 的 Preview 来 预览 一 下 当前 布局 ， 如 图 2.6 所 示 。 
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图 2.6 预览 当前 布局 


可 以 看 到 ， 按 钮 已 经 成 功 显示 出 来 了 ， 这 样 一 个 简单 的 布局 就 编写 完成 
了 。 那 么 接 下 来 我 们 要 做 的 ， 就 是 在 活动 中 加 载 这 个 布局 。 


重新 回 到 FirstActivity， 在 oncreate() 方 法 中 加 入 如 下 代码 : 











public class FirstActivity extends AppCompatActivity { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.first_ layout); 


} 


可 以 看 到 ， 这 里 调用 了 setcontentview() 方 法 来 给 当前 的 活动 加 载 一 个 
布局 ， 而 在 setcontentVview() 方 法 中 ， 我 们 一 般 都 会 传 入 一 个 布局 文件 
的 id。 在 第 1 章 介绍 项 目 资 源 的 时 候 我 曾 提 到 过 ， 项 目 中 添加 的 任何 资 
源 都 会 在 R 文 件 中 生成 一 个 相应 的 资源 id 因此 我 们 刚才 创建 的 
first_layout ,xml 布局 的 id 现在 应 该 是 已 经 添加 到 R 文 件 中 了 。 在 代码 
中 去 引用 布局 文件 的 方法 你 也 已 经 学 过 了 ， 只 需要 调 

用 R. layout.first _layout 就 可 以 得 到 first_ layout .xm1 布 局 的 id， 然后 
将 这 个 值 传 入 setcontentView() 方 法 即 可 。 


2.2.3 在 AndroidManifest 文 件 中 注册 


列 筷 了 在 上 一 章 我 们 学 过 ， 所 有 的 活动 都 要 在 AndroidManifest.xml 中 进 
行 注册 才能 生效 ， 而 实际 上 FirstActivity 已 经 在 AndroidManifest.xml 中 注 
册 过 了 ， 我 们 打开 app/srcmain/AndroidManifest.xml 文 件 瞧 一 瞧 ， 代 码 如 
下 所 示 : 


<manifest xmln angro id= he “人 che Das android.com/apk/res/android" 
= amp1 ityte 











me 
.Fi sta tivity"></activity> 


可 以 看 到 ， 活 动 的 注册 声明 要 放 在 <application> 标 签 内 ， 这 里 是 通过 

<activity> 标 签 来 对 活动 进行 注册 的 。 那 么 又 是 谁 帮 我 们 自动 完成 了 对 

FirstActivity 的 注册 呢 ? 当然 是 Android ”Studio 了， 之 前 在 使 用 Eclipse 创 

建 活动 或 其 他 系统 组 件 时 ， 很 多 人 都 会 忘记 要 去 Android Manifest.xml 中 

Se 运行 朋 涡 ， 很 显 然 Android Studio 在 这 方面 做 得 
中 


在 <activity> 标 签 中 我 们 使 用 了 android:name 来 指定 具体 注册 哪 一 个 活 
动 ， 那么 这 里 填 入 的 .FirstActivity 是 什么 意思 呢 ? 其 实 这 不 过 就 
是 com.example.activitytest.FirstActivity 的 缩写 而 已 。 由 于 在 最 外 
层 的 <manifest> 标 签 中 已 经 通过 package 属 性 指定 了 程序 的 包 名 

是 com.example.activitytest， 因 此 在 注册 活动 时 这 一 部 分 就 可 以 省 上 略 

















了 了， 直接 使 用 .FirstActivity 就 足够 了 o 


不 过 ， 仅 仅 是 这 样 注 册 了 活动 ， 我 们 的 程序 仍然 是 不 能 运行 的 ， 因 为 还 
没有 为 程序 配置 主 活动 ， 也 就 是 说 ， 当 程序 运行 起 来 的 时 候 ， 不 知道 要 
首先 司 动 哪个 活动 。 配 置 主 活动 的 方法 其 实在 第 1 章 中 已 经 介绍 过 了 ， 

就 是 在 <activity> 标 签 的 内 部 加 入 <intent-filter> 标 签 ， 并 在 这 个 标签 
里 添加 <action android:name="android.intent.action.MAIN"/> 和 
<category android: name="android.intent.category.LAUNCHER" /> 这 


两 句 声明 即 可 。 


除 此 之 外 ， 我 们 还 可 以 使 用 android:1label 指 定 活动 中 标题 栏 的 
标题 栏 是 显示 在 活动 最 顶部 的 ， 待 会 儿 运 行 的 时 候 你 就 会 看 到 。 

意 的 是 ， 给 主 活动 指定 的 label 不 仅 会 成 为 标题 栏 中 的 内 容 ， SS 
动 右 《Launcher) 中 应 用 程序 显示 的 名 称 。 


修改 后 的 AndroidManifest.xml 文 件 ， 代 码 如 下 所 示 : 


st xmlns:android= th 1 让 na android.com/apk/res/android" 
cka Ae Con example. 
“applie Cat on 











en > 

<action android:name="android.intent.ac on /> 

tegory andt ond ances Goros dn ntent.cate ego er SUN /> 
小 > 


这 样 的 话 ，FirstActivity 惑 成 为 我 们 这 个 程序 的 主 活动 了 ， 即 点 击 更 面 应 
用 程序 图 标 时 首先 打开 的 残 是 这 个 活动 。 男 外 需要 注意 ， 如 果 你 的 应 用 
程序 中 没有 声明 任何 一 个 活动 作为 主 活动 ， 这 个 程序 仍然 是 可 以 正常 安 
装 的 ， 只 是 你 无 法 在 启动 器 中 看 到 或 者 打开 这 个 程序 。 这 种 程序 一 股 才 
i 如 支付 宝 快 捷 支 付 服 














好 了 ， 现 在 一 切 都 已 准备 就 纤 ， 让 我 们 来 运行 一 下 程序 吧 ， 结 果 如 图 
2.7 所 示 。 
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图 2.7 首次 运行 结 

在 界面 的 最 项 部 是 一 个 标题 栏 ， 里 面 显示 着 我 们 刚才 在 注册 活动 时 指定 
的 内 容 。 标 题 栏 的 下 面 就 是 在 布局 文件 first_layout.xml 中 编写 的 界面 ， 

可 以 看 到 我 们 刚刚 定义 的 按钮 。 现 在 你 已 经 成 功 掌 握 了 手动 创建 活动 的 
方法 ， 下 面 让 我 们 继续 看 一 看 你 在 活动 中 还 能 做 哪些 事情 吧 。 


2.2.4 在 活动 中 使 用 Toast 

Toast 是 Android 系 统 提供 的 一 种 非常 好 的 提醒 方式 ， 在 程序 中 可 以 使 用 
它 将 一 些 短小 的 信息 通知 给 用 户 ， 这 些 信 息 会 在 一 段 时 间 后 自动 消失 ， 
并 且 不 会 占用 任何 屏幕 空间 ， 我 们 现在 就 答 试 一 下 如 何在 活动 中 使 用 


Toast。 


首先 需要 定义 一 个 弹出 Toast 的 触发 点 ， 正 好 界面 上 有 个 按钮 ， 那 我 们 

















就 让 点 击 这 个 按钮 的 时 候 弹出 一 个 Toast 吧 。 在 oncreate() 方 法 中 添加 如 
下 代码 ; 


protected void onCreate(Bundle savedInstanceState) { 

super .onCreate(savedIinstanceSstate); 
setContentView(R.1layout.first_layout); 
Button button1 = (Button) findViewById(R.id.button_ 1); 
button1l.setonClickListener(new View.OnClickListener() { 

@Override 

public void onClick(View v 

Toast.makeText(FirstActivity.this, "You clicked Button 1" 
Toast .LENGTH_SHORT) .show() ; 
} 


}); 





在 活动 中 ， 可 以 通过 findviewById() 方 法 获取 到 在 布局 文件 中 定义 的 元 
素 ， 这 里 我 们 传 入 R.id.button_1， 来 得 到 按钮 的 实例 ， 这 个 值 是 刚才 

在 first_layout.xml 中 通过 android:id 属 性 指定 的 。findviewById() 方 法 返 
回 的 是 一 个 view 对 象 ， 我 们 需要 同 下 转型 将 它 转 成 Button 对 象 。 得 到 按 
钮 的 实例 之 后 ， 我 们 通过 调用 setonclickListener() 方 法 为 按钮 注册 一 
个 监听 器 ， 点 击 按 钮 时 束 会 执行 监听 右 中 的 onclick() 方 法 。 因 此 ， 弹 

出 Toast 的 功能 当然 是 要 在 onclick() 方 法 中 编写 了 。 


Toast 的 用 法 非常 简单 ， 通 过 静态 方法 makeText() 创 建 出 一 个 Toast 对 
象 ， 然 后 调用 show() 将 Toast 显 示 出 来 束 可 以 了 。 这 里 需要 注意 的 

是 ，makeText() 方 法 需要 传 入 3 个 参数 。 第 一 个 参数 是 context， 也 束 是 
Toast 要 求 的 上 下 文 ， 由 于 活动 本 里 就 是 一 个 context 对 象 ， 因 此 这 里 直 
接 传 入 FirstActivity.this 即 可 。 第 二 个 参数 是 Toast 显 示 的 文本 内 容 ， 
第 三 个 参数 是 Toast 显 示 的 时 长 ， 有 两 个 内 置 常量 可 以 选择 

Toast. LENGTH_SHORT 和 Toast ,LENGTH_LONG。 


现在 重新 运行 程序 ， 并 点 击 一 下 按钮 ， 效 果 如 图 2.8 所 示 。 















This is FirstActivity 





BUTTON 1 


You clicked Button 1 









图 2.8 Toast 运 行 效 果 
2.2.5 在 活动 中 使 用 Menu 


手机 毕竟 和 电脑 不 同 ， 它 的 屏幕 空间 非常 有 限 ， 因 此 充分 地 利用 屏幕 空 
间 在 手机 界面 设计 中 就 显得 非常 重要 了 。 如 果 你 的 活动 中 有 大 量 的 菜单 
需要 显示 ， 这 个 时 候 界 面 设计 就 会 比较 尴 界 ， 因 为 仅 这 些 菜单 就 可 能 占 
用 屏幕 将 近 三 分 之 一 的 空间 ， 这 该 怎么 办 呢 ? 不 用 担心 ，Android 给 我 
人 
屏幕 空间 。 


首先 在 res 目 录 下 新 建 一 个 menu 文 件 严 ， 右 击 res 目 录 

-New Directory， 输 入 文件 夹 名 menu， 点 击 OK。 接 着 在 这 个 文件 夹 
下 再 新 建 一 个 名 叫 main 的 菜单 文件 ， 右 击 menu 文 件 夹 , New -Menu 
resource file， 如 图 2.9 所 示 。 
































New Menu Resource File 
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图 2.9 新 建 Menu 资 源 文件 


文件 名 输入 main， 点 击 OK 完 成 创建 。 然 后 在 main.xml 中 添加 如 下 代 
码 : 


<menu xmlns:android="http://schemas.android.com/apk/res/android"> 
android:id="@+id/add_item" 
android:title="Add"/> 
<item 
android:id="@+id/remove_item" 
android:title="Remove"/> 
</menu> 


这 里 我 们 创建 了 两 个 菜单 项 ， 其 中 <item> 标 签 就 是 用 来 创建 具体 的 某 一 
站 菜单 项 ， 然 后 通过 android:id 给 这 个 菜单 项 指定 一 个 唯一 的 标识 符 ， 
通过 android:title 给 这 个 菜单 项 指定 一 个 名 称 。 


接着 重新 加 到 FirstActivity 中 来 重 写 oncreateoptionsMenu() 方 法 ， 重 写 方 
法 可 以 使 用 Ctrl + O 快 捷 键 (Mac 系 统 是 control + O，〉， 如 图 2.10 所 示 。 





两 Select Methods to Override/Implement 


[ he rh en MotionEvent):bool' 


由 dispatchGenericMotionEvent(ev:MotionEvent) 
dispatchPopulateAccessibilityEvent(event:Acce 
9 onCreatePanelView(featureld:int)}:View 
onCreateOptionsMenu(menu:Menu):boolean 
记 onPrepareOptionsMenu(menu:Menu):booleal 
onOQptionsltemSelected(item:Menultem):boo| 
9 onNavigateUp0:boolean 
onNavigateUpFromChild(child:Activity):booles 
onCreateNavigateUpTaskStack(builder:TaskS 


@@Oo0e0osmeooee, 


L | Copy JavaDoc 


Insert @Override 屿 ZZ 计 | Cancel | 


图 2.10 重 写 oncreateoptionsMenu() 方 法 











然后 在 oncreateoptionsMenu() 方 法 中 编写 如 下 代码 : 


public boolean onCreateOptionsMenu(Menu menu) { 
getMenuInflater().inflate(R.menu.main, menu); 
return true; 


} 


通过 getMenuInflater() 方 法 能 够 得 到 MenuInflater 对 象 ， 再 调用 它 的 

inflate() 方 法 惑 可 以 给 当前 活动 创建 生 单 了 。inflate() 方 法 接收 两 个 
参数 ， 第 一 个 参数 用 于 指定 我 们 通过 哪 一 个 资源 文件 来 创建 淋 单 ， 这 里 
当然 传 入 R.menu.main。 第 二 个 参数 用 于 指定 我 们 的 菜单 项 将 添加 到 哪 
一 个 Menu 对 象 当 中 ， 这 里 直接 使 用 oncreateoptionsMenu() 方 法 中 传 入 的 
menu 人 参数 。 然 后 给 这 个 方法 返回 true， 表 示人 允许 创建 的 菜单 显示 出 来 ， 

如 果 返 回 了 false， 创 建 的 逐 单 将 无 法 显示 。 


当然 ， 仅 仅 让 沫 单 显示 出 来 是 不 够 的 ， 我 们 定义 荣 单 不 仅 是 为 了 看 的 ， 
关键 是 要 菜单 真正 可 用 才 行 ， 因 此 还 要 再 定义 沫 单 啊 应 事件 。 在 
FirstActivity 中 重 写 onoptionsItemSelected() 方 法 : 

















public boolean onOptionsItemSelected(MenuItem item) { 
switch (item. ert) ‘ 
case R.id.add it 


Toast .makeText(this，"You clicked Add"，Toast .LENGTH_SHORT) .show() ， 
break; 

case R.id.remove_item: 
Toast.makeText(this, "You clicked Remove", Toast .LENGTH_SHORT).show(); 
break; 

default: 


return true; 


在 onoptionsItemSelected( ) 方 法 中 ， 通 过 调用 itenm. getItemId( ) 来 判断 
我 们 点 击 的 是 哪 一 个 表 单 项 ， 然 后 给 每 个 菜单 项 加 入 自己 的 逻辑 处 理 ， 
这 里 我 们 束 活 学 活用 ， 弹 出 一 个 刚刚 学 会 的 Toast。 


重新 运行 程序 ， 你 会 发 现在 标题 栏 的 右 侧 多 了 一 个 三 点 的 符号 ， 这 个 就 
是 菜单 按钮 了 ， 如 图 2.11 所 示 。 


This is FirstActivity 


BUTTON 1 








图 2.11 带 菜单 按钮 的 活动 
可 以 看 到 ， 菜 单 里 的 菜单 项 默认 是 不 会 显示 出 来 的 ， 只 有 点 击 一 下 菜单 


Ne ss 
2.12 有 [未 。 
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This is FirstActivity 
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图 2.12 ”弹出 荣 单 项 的 界面 


然后 如 果 你 点 击 了 Add 荣 单项 就 会 弹出 You dlicked _ Add 提示“〈 如 图 2.13 
所 示 ) ， 如 果 点 击 了 Remove 菜 单项 就 会 弹出 You clicked Remove 提 示 。 







This is FirstActivity 


BUTTON 1 





You clicked Add 









图 2.13 点 击 了 Add 演 单项 
2.2.6 ”销毁 一 个 活动 


通过 上 一 节 的 学 习 ， 你 已 经 掌握 了 手动 创建 活动 的 方法 ， 并 学 会 了 如 何 
在 活动 中 创建 Toast 和 创建 菜单 。 或 许 你 现在 心中 会 有 个 疑惑 ， 如 何 销 
毁 一 个 活动 呢 ? 

其 实 答案 非常 简单 ， 只 要 按 一 下 Back 键 就 可 以 销毁 当前 的 活动 了 。 不 过 
如 果 你 不 想 通 过 按键 的 方式 ， 而 是 希望 在 程序 中 通过 代码 来 销毁 活动 ， 
当然 也 可 以 ，Activity 类 提供 了 一 个 finish() 方 法 ， 我 们 在 活动 中 调用 一 
下 这 个 方法 就 可 以 销毁 当前 活动 了 。 


修改 按钮 监听 器 中 的 代码 ， 如 下 所 示 : 


button1l.setonCclickListener(new View.OnClickListener() { 
@Override 





public void onClick(View v) { 
finish() 


inish(); 











重新 运行 程序 ， 这 时 点 击 一 下 按钮 ， 当 前 的 活动 就 被 成 功 销毁 了 ， 效 果 
和 按 下 Back 键 是 一 样 的 。 


2.3 ”使 用 Intent 在 活动 之 间 罕 梭 


只 有 一 个 活动 的 应 用 也 太 简 单 了 吧 ? 没 错 ， 你 的 追求 应 该 更 高 一 点 。 不 
管 你 想 创 建 多 少 个 活动 ， 方 法 都 和 上 一 节 中 介绍 的 是 一 样 的 。 唯 一 的 问 
题 在 于 ， 你 在 局 动 器 中 点 击 应 用 的 图 标 只 会 进入 到 该 应 用 的 主 活动 ， 那 
么 怎样 才能 由 主 活动 跳 转 到 其 他 活动 呢 ? 我 们 现在 就 来 一 起 看 一 看 。 











2.3.1 ”使 用 显 式 Intent 


你 应 该 已 经 对 创建 活动 的 流程 比较 熟悉 了 ， 那 我 们 现在 快速 地 在 
ActivityTest 项 目 中 再 创建 一 个 活动 。 


仍然 还 是 右 击 com.example.activitytest 包 ,New Activity “Empty 
Activity， 会 弹出 一 个 创建 活动 的 对 话 框 ， 我 们 这 次 将 活动 命名 为 
SecondActivity， 并 勾 选 Generate ”Layout ” File， 给 布局 文件 起 名 为 
second_layout， 但 不 要 勾 选 Launcher Activity 选 项 ， 如 图 2.14 所 示 。 





Configure Activity 


Android Studio 


Creates a new empty activity 
Activity Name: | SecondActivity 
Generate Layout File 
| second_layout 


[ Launcher Activity 
Backwards Compatibility (AppCompat) 


Package name: com.example.activitytest 
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图 2.14 创建 SecondActivity 


点 击 Finish 完 成 创建 ，Android Studio 会 为 我 们 自动 生成 
SecondActivity.java 和 second_layout.xml 这 两 个 文件 。 不 过 自动 生成 的 布 
局 代码 目前 对 你 来 说 可 能 有 些 复杂 ， 这 里 我 们 仍然 还 是 使 用 最 熟悉 的 
LinearLayout， 编 辑 second_layout.xml， 将 里 面 的 代码 蔡 换 成 如 下 内 容 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
ndroid:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 





<Button 
android:id="@+id/button_2" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Button 2" 
Rn 


</LinearLayout> 


我 们 还 是 定义 了 一 个 按钮 ， 按 钮 上 显示 Button 2。 


然后 SecondActivity 中 的 代码 已 经 自动 生成 了 一 部 分 ， 我 们 保持 默认 不 
变 就 好 ， 如 下 上 所 示 : 


public class SecondActivity extends AppCompatActivity { 


@override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.second_layout); 


} 











男 外 不 要 和 态 记 ， 任 何 一 个 活动 都 是 需要 在 AndroidManifest.xml 中 注册 
的 ， 不 过 幸运 的 是 ，Android Studio 已 经 帮 有 我 们 自动 完成 了 ， 你 可 以 打开 
AndroidManifest.xml 瞧 一 瞧 ; 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<activity 
android:name=".FirstActivity” 
android:label="This is FirstActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category nro name="android.intent. a LAUNCHER" /> 
</intent-filte 
</activity> 
<activity android:name=".SecondActivity"></activity> 
</application> 





由 于 SecondActivity 不 是 主 活动 ， 因 此 不 需要 配置 <intent-filter> 标 签 
里 的 内 容 ， 注 册 活 动 的 代码 也 简单 了 许多 。 现 在 第 二 个 活动 已 经 创建 完 
成 ， 剩 下 的 问题 就 是 如 何 去 启 动 这 第 二 个 活动 了 ， 这 里 我 们 需要 引入 一 
个 新 的 概念 : Intent。 


Intent 是 Android 程 序 中 各 组 件 之 间 进 行 交 互 的 一 种 重要 方式 ， 它 不 仅 可 
以 指明 当前 组 件 想 要 执行 的 动作 ， 还 可 以 在 不 同 组件 之 间 传 递 数 据 。 
Intent 一 般 可 被 用 于 启动 活动 、 启 动 服 务 以 及 发 送 广播 等 场景 ， 由 于 服 
务 、 厂 播 等 概念 你 暂时 还 未 涉及 ， 那 么 本 章 我 们 的 目光 无 疑 束 锁定 在 了 
局 动 活动 上 面 。 


Intent 大 致 可 以 分 为 两 种 : 显 式 Intent 和 隐 式 Intent， 我 们 先 来 看 一 下 显 
式 Intent 如 何 使 用 。 


Intent 有 多 个 构造 函数 的 重 载 ， 其 中 一 个 是 Intent(Context 











packageContext， Class<?> cls)。 这 个 构造 图 数 接收 两 个 参数 ， 
0 
定 想 要 局 动 的 目标 活动 ， 通过 这 个 构造 函数 束 可 以 构建 出 Intent 的 “ 意 
多 然后 我 们 应 该 怎么 使 用 这 个 Intent 呢 ? Activity 类 中 提供 了 一 

个 startActivity() 方 法 ， 这 个 方法 是 专门 用 于 启动 活动 的 ， 它 接收 一 
个 Intent 参 数 ， 这 里 我 们 将 构建 好 的 Intent 传 入 startActivity() 方 法 就 
可 以 启动 目 标 活动 了 。 


修改 FirstActivity 中 按钮 的 点 击 事 件 ， 代 码 如 下 所 示 : 


button1l.setonClickListener(new View.OnClickListener() { 
@Ooverride 
public void onClick(View v) { 
Intent intent = new Intent(FirstActivity.this, SecondActivity.class); 
startActivity(intent); 
} 
}); 











我 们 首先 构建 出 了 一 个 Intent， 传 入 FirstActivity.this 作 为 上 下 文 ， 传 

入 SecondActivity.class 作 为 目标 活动 ， 这 样 我 们 的 “ 意 网 ” 束 非 常 明显 

由 WO 的 基础 上 打开 SecondActivity 这 个 活动 。 
然后 通过 startActivity() 方 法 来 执行 这 个 Intent。 


重新 运行 程序 ， 在 FirstActivity 的 界面 点 击 一 下 按钮 ， 结 果 如 图 2.15 所 
加 \o 











ActivityTest 


BUTTON 2 








图 2.15 ”SecondActivity 界 面 


可 以 看 到 ， 我 们 已 经 成 功 启动 SecondActivity 这 个 活动 了 。 如 果 你 想 要 
回 到 上 一 个 活动 怎么 办 呢 ? 很 简单 ， 按 下 Back 键 就 可 以 销毁 当前 活动 ， 
从 而 回 到 上 一 个 活动 了 。 


使 用 这 种 方式 来 启动 活动 ，Intent 的 “意图 ”非常 明显 ， 因 此 我 们 称 之 为 
显 式 Intent。 


2.3.2 ”使 用 隐 式 Intent 


相 比 于 显 式 Intent， 隐 陈 Intent 则 含蓄 了 许多 ， 筷 并 不 明确 指出 我 们 想 要 
局 动 哪 一 个 活动 ， 而 是 指定 了 一 系列 更 为 抽象 的 action 和 category 等 信 
轧 ， 然 后 交 由 系统 去 分 析 这 个 Intent， 并 帮 我 们 找 出 合适 的 活动 去 局 


动 。 





什么 叫 作 合适 的 活动 呢 ? 简单 来 说 就 是 可 以 响应 我 们 这 个 隐 式 Intent 的 
活动 ， 那 么 目前 SecondActivity 可 以 响应 什么 样 的 隐 式 Intent 呢 ? 额 ， 现 
在 好 像 还 什么 都 啊 应 不 了 ， 不 过 很 快 就 会 有 了 。 


通过 在 <activity> 标 答 下 配置 <intent-filter> 的 内 容 ， 可 以 指定 当前 活 
动能 够 啊 应 的 action 和 category， 打 开 AndroidManifest.xml， 添 加 如 下 
代码 ; 


<activity android:name=".SecondActivity" > 
<intent-filter> 
<action android:name="com.example.activitytest.ACTION_START" /> 
<category android:name="android.intent.category.DEFAULT" /> 
</intent-filter> 
</activity> 





在 <action> 标 签 中 我 们 指明 了 当前 活动 可 以 啊 应 

Com: example.activitytest. ACTION_START 这 个 action， 而 <category> 标 
签 则 包含 了 一 些 附 加 信息 ， 更 精确 地 指明 了 当前 的 活动 能 够 啊 应 的 

Intent 中 还 可 能 带 有 的 category。 只 有 <action> 和 <category> 中 的 内 容 同 

时 能 够 匹配 上 ntent 中 指定 的 action 和 category 时 ， 这 个 活动 才能 啊 应 该 


Intent。 


修改 FirstActivity 中 按钮 的 点 击 事件 ， 代 码 如 下 所 示 : 


button1l.setonClickListener(new View.OnClickListener() { 
@override 
public void onClick(View v) { 
Intent intent = new Intent("com.example.activitytest.ACTION_START"); 
startActivity(intent); 
} 
}); 


可 以 看 到 ， 我 们 使 用 了 Intent 的 另 一 个 构造 函数 ， 直 接 将 action 的 字符 
串 传 了 进去 ， 表 明 我 们 想 要 局 动能 够 啊 应 
com,example.activitytest,.ACTION_START 这 个 action 的 活动 。 那 前 面 不 
是 说 要 <action> 和 <category> 同 时 匹配 上 才能 响应 的 吗 ? 怎么 没 看 到 哪 
里 有 指定 category 呢 ? 这 是 因为 android,intent,category.DEFAULT 是 一 
种 默认 的 category， 在 调用 startActivity() 方 法 的 时 候 会 自动 将 这 

个 category 添 加 到 Intent 中 。 


重新 运行 程序 ， 在 FirstActivity 的 界面 点 击 一 下 按钮 ， 你 同样 成 功 局 动 
SecondActivity 了 。 不 同 的 是 ， 这 次 你 是 使 用 了 隐 式 Intent 的 方式 来 启动 
的 ， 说 明 我 们 在 <activity> 标 签 下 配置 的 action 和 category 的 内 容 已 经 











本 用 了 


每 个 Intent 中 只 能 指定 一 个 action， 但 却 能 指定 多 个 category。 目前 我 们 
的 Intent 中 只 有 一 个 默认 的 category， 那 么 现在 再 来 增加 一 个 吧 。 


修改 FirstActivity 中 按钮 的 点 击 事 件 ， 代 码 如 下 所 示 : 


button1l.setonClickListener(new View.OnClickListener() { 
@Override 
public void onClick (View v) 区 
Intent intent = new Intent("com.example.activitytest.ACTION_ START"); 
intent.addCategory("com.example.activitytest.MY_CATEGORY"); 
startActivity(intent); 
} 
}); 


可 以 调用 Intent 中 的 addcategory() 方 法 来 添加 一 个 category， 这 里 我 们 
指定 了 -个 自 定义 的 category， 值 


为 com. example.activitytest.MY_CATEGORY。 


现在 重新 运行 程序 ， 在 FirstActivity 的 界面 点 击 一 下 按钮 ， 你 会 发 现 ， 程 
序 骨 尝 了 ! 这 是 你 第 一 次 过 到 程序 崩 淡 ， 可 能 会 有 些 束手无策 时 
张 ， 其 实 大 多 数 的 月 尝 问题 都 是 很 好 解决 的 ， 只 要 你 :善于 分 析 。 在 
logcat 界 面 查看 错误 日 志 ， 你 会 看 到 如 图 2.16 所 示 的 错误 信息 。 














Process: com. example.activitytest, PID: 24027 
android. content, ActivityNotFomdException: No Activity found to handle Intent { 
act=com. example. activitytest. ACTION_START cat=[com. example. activitytest. MY CATEGORY] } 


图 2.16 错误 信息 4D 


错误 信息 二 提要 我 们 ， 没有 任何 一 个 活动 可 以 啊 应 我 们 的 Intent， 为 什 
么 昵 ?这 是 因为 我 们 刚刚 在 Intent 中 新 增 了 一 个 category， 而 

SecondActivity 的 <intent filter> 标 签 中 并 没有 声明 可 以 啊 应 这 

个 category， 所 以 就 出 现 了 没有 任何 活动 可 以 啊 应 该 mtent 的 情况 。 现 在 

我 们 在 <intent-filter> 中 再 添加 一 个 category 的 声明 ， 如 下 所 示 : 


<activity android:name=".SecondActivity" > 
<intent-filter> 
<action android:name="com.example.activitytest.ACTION_START" /> 
<category android:name="android.intent.category.DEFAULT" /> 
<category android:name="com.example.activitytest.MY_CATEGORY"/> 
</intent-filter> 
</activity> 











再 次 重新 运行 程序 ， 你 就 会 发 现 一 切 都 正常 了 。 


2.3.3 ”更 多 隐 式 Intent 的 用 法 


上 一 节 中 ， 你 掌握 了 通过 隐 式 Intent 来 启动 活动 的 方法 ， 但 实际 上 隐 式 
Intent 还 有 更 多 的 内 容 需 要 你 去 了 解 ， 本 节 我 们 束 来 展开 介绍 一 下 。 


使 用 隐 式 Intent， 我 们 不 仅 可 以 启动 自己 程序 内 的 活动 ， 还 可 以 局 动 其 
这 使 得 Android 多 个 应 用 程序 之 间 的 功能 共享 成 为 了 可 

比如 说 你 的 应 用 程序 中 需要 展示 一 个 网 页 ， 这 时 你 “没有 必要 目 己 去 
实现 一 个 浏览 器 (事实 上 也 不 太 可 能 ) ， 而 是 只 需要 调用 系统 的 浏览 器 
来 打开 这 个 网 页 就 行 了 。 


修改 FirstActivity 中 按钮 点 击 事件 的 代码 ， 如 下 所 示 : 


buttoni.s eton ClickListener(new View.OnClickListener() { 
@ 























verri 
public voil cid on wie ck(Vi ew V) { 

i nte 时 = new 如 Wa nt(Intent.ACTION. ra 
Re ta(Uri.parse("http://www.baidu m" ) ) ， 
这 vity(inte Ee 


二 让 
nte 


nt 
nt . 
rtAc 


} 
}); 


这 这 里 我 们 首先 指定 了 Intent 的 action 是 Intent .ACTION_VIEW， 这 是 一 个 
Android 系 统 内 置 的 动作 ， 其 常量 值 为 android.intent.action.VIEW。 然 
后 通过 uri.parse() 方 法 ， 将 一 个 网 址 字符 串 解析 成 一 个 uri 对 象 ， 再 调 
用 Intent 的 setData() 方 法 将 这 个 uri 对 象 传递 进去 。 


重新 运行 程序 ， 在 FirstActivity 界 面 点 击 按钮 就 可 以 看 到 打开 了 系统 浏览 
器 ， 如 图 2.17 所 示 。 





加 wwwbaidu.com 


电影 团购 


me 手机 百度 








图 2.17 系统 浏览 右 界 面 


在 上 述 代 码 中 ， 可 能 你 会 对 setData() 部 分 感觉 到 陌生 ， 这 是 我 们 前 面 
没有 讲 到 的 。 这 个 方法 其 实 并 不 复杂 ， 它 接收 一 个 Uri 对象， 主要 用 于 
指定 当前 Intent 正 在 操作 的 数据 ， 而 这 些 数据 通常 都 是 以 字符 串 的 形式 
传 入 到 uri.parse() 方 法 中 解析 产生 的 。 


与 此 对 应 ， 我 们 还 可 以 在 <intent-filter> 标 签 中 再 配置 一 个 <data> 标 
签 ， 用 于 更 精确 地 指定 当前 活动 能 够 响应 什么 类 型 的 数据 。<data> 标 签 
中 主要 可 以 配置 以 下 内 容 。 











。android:scheme。 用 于 指定 数据 的 协议 部 分 ， 如 上 例 中 的 http 冰 
hg 


。 android:host。 用 于 指定 数据 的 主机 名 部 分 ， 如 上 例 中 的 


www.baidu.com 部 分 。 


。 android:port。 用 于 指定 数据 的 端口 部 分 ， 一 般 紧 随 在 主机 名 之 


后 。 


。 android:path。 用 于 指定 主机 名 和 端口 之 后 的 部 分 ， 如 一 上段 网 址 中 
跟 在 域名 之 后 的 内 容 。 


e android:mimeType。 用 于 指定 可 以 处 理 的 数据 类 型 ， 允许 使 用 通 配 
符 的 方式 进行 指定 。 


只 有 <data> 标 签 中 指定 的 内 容 和 JIntent 中 携带 的 Data 完 全 一 致 时 ， 当 前 活 
动 才 和 人 够 啊 应 该 Intent。 0 | 
容 ， 如 上 面 浏览 器 示例 中 ， 其 实 只 需要 指定 android:scheme 为 http， 就 
可 以 响应 所 有 的 http 协 议 的 tent 了 。 


为 了 让 你 能 够 更 加 直观 地 理解 ， 我 们 来 自己 建立 一 个 活动 ， 让 它 也 能 啊 
应 打开 网 页 的 Intent。 


右 击 com.example.activitytest 包 -,New -Activity-,Empty Activity， 新 建 
ThirdActivity， 并 勺 选 Generate Layout File， 给 布局 文件 起 名 为 
third_layout， 点 击 Finish 完 成 创建 。 然 后 编辑 third_layout.xml， 将 里 面 的 
代码 蔡 换 成 如 下 内 容 : 


<LinearLayout xmlns: android= "http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width= “niatch _parent" 
android:layout_height="match_parent"> 


<Button 
android:id="@+id/button_3" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Button 3 
/> 


</LinearLayout> 





ThirdActivity 中 的 代码 保持 不 变 就 可 以 了 ， 最 后 在 AndroidManifest.xml 中 
修改 ThirdActivity 的 注册 信息 : 


<activity a name=" .ThirdActivity"> 
<intent-filte 
<action snotold: name="android.intent.action.VIEW" /> 
<category android: name= "android.intent.category.DEFAULT" /> 
<data android:scheme="http" /> 
</intent-filter> 
</activity> 


我 们 在 ThirdActivity 的 <intent-filter> 中 配置 了 当前 活动 和 E 够 响应 的 
action 是 Intent .ACTION_VIEW 的 常量 值 ， 而 category 则 之 无 竖 问 指定 了 
默认 的 category 值 ， 另 外 在 <data> 标 签 中 我 们 通过 android:scheme 指 定 
J 了 数据 的 协 议 必 须 是 http 协 议 ， 这 样 ThirdActivity 应 该 就 和 浏览 嚣 一样， 

能 够 啊 应 一 个 打开 网 页 的 Intent 了 。 el 下 程 序 试 试 吧 ， 在 
FirstActivity 的 界面 点 击 一 下 按钮 ， 结 果 如 图 2.18 所 示 。 
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图 2.18 ”选择 响应 Intent 的 程序 


可 以 看 到 ， 系 统 上 自动 弹出 了 一 个 列表 ， 显 示 了 目前 能 够 啊 应 这 个 Intent 
的 所 有 程序 。 选 择 Browser 还 会 像 之 前 一 样 打开 浏览 器 ， 并 显示 百度 的 
主页 ， 而 如 果 选 择 了 ActivityTest， 则 会 启动 ThirdActivity。JUST ONCE 
表示 只 是 这 次 使 用 选择 的 程序 打开 ，ALWAYS 则 表示 以 后 一 直 都 使 用 
这 次 选择 的 程序 打开 。 需 要 注意 的 是 ， 虽 然 我 们 声明 了 ThirdActivity 是 
可 以 啊 应 打开 网 页 的 Intent 的 ， 但 实际 上 这 个 活动 并 没有 加 载 并 显示 网 











页 的 功能 ， 所 以 在 真正 的 项 目 中 尽量 不 要 出 现 这 种 有 可 能 误导 用 户 的 行 
为 ， 不 然 会 让 用 户 对 我 们 的 应 用 产生 负面 的 印象 。 


除了 http 协 议 外 ， 我 们 还 可 以 指定 很 多 其 他 协议 ， 比 如 geo 表 示 显 示 地 理 
， 下 面 的 代码 展示 了 如 何在 我 们 的 程序 中 调用 系 
统 拨 亏 界 面 。 


buttonl . Seton ClickListener(new View.OnClickListener() { 
@ 


public void 1 ck(View v) { 
tent intent = new en nt(In ntent .ACTION_DIAL); 
ntent. setoata(ur Epar se("tel:10086")); 
Star tActivity(intent); 


首先 指定 了 Intent 的 action 是 Intent.,ACTION_DIAL， 这 又 是 一 个 Android 系 
统 的 内 置 动作 。 然后 在 data 部 分 指定 了 协议 是 tel， 写 码 是 10086。 重 新 运 
行 一 下 程序 ， 在 FirstActivity 的 界面 点 击 一 下 按钮 ， 结 果 如 图 2.19 所 示 。 


+ Create new contact 


名 Addtoacontact 


周 send SMS 
10086 
1 2 3 
a 0 
ke 








图 2.19 系统 拨号 界面 
2.3.4 问 下 一 个 活动 传递 数据 


过 前 面 几 节 的 学 习 ， 你 已 经 对 Intent 有 了 一 定 的 了 解 。 不 过 到 目前 为 
我 们 都 只 是 简单 地 使 用 Intent 来 启动 一 个 活动 ， 其 实 Intent 还 可 以 在 
启动 活动 的 时 候 传递 数据 ， 下 面 我 们 来 一 起 看 一 下 。 


在 启动 活动 时 传递 数据 的 思路 很 简单 ，Intent 中 提供 了 一 系列 putExtra() 
方法 的 重 载 ， 可 以 把 我 们 想 要 传递 的 数据 暂 存 在 Intent 中 ， 启 动 了 男 一 
个 活动 后 ， 只 需要 把 这 些 数 据 再 从 Intent 中 取出 就 可 以 了 。 比 如 说 
FirstActivity 中 有 一 个 字符 串 ， 现 在 想 把 这 个 字符 串 传 递 到 
SecondActivity 中 ， 你 就 可 以 这 样 编写 : 


buttonl . eton ClickListener(new View.OnClickListener() { 
public void o nclic ck(Vi ew 2 
Str he a ta Hello ondActivity"; 
开 tent inte nt = New mr Ce nt(Fir A tivity.thi SecondActivity.class); 
ntent . 0 Dt ra("extra_data", data); 
Se rtActi et nte Es 
. 
}); 


这 里 我 们 还 是 使 用 显 式 Intent 的 方式 来 启动 SecondActivity， 并 通过 
putExtra() 方 法 传递 了 一 站 字符 串 。 注 意 这 里 putExtra( ) 方 法 接收 两 个 
参数 ， 第 一 个 参数 是 键 ， 用 于 后 面 从 Intent 中 取 值 ， 第 二 个 参数 才 是 真 
正 要 传递 的 数据 。 


人 并 打印 出 来 ， 代 码 如 
下 所 示 : 


public class SecondActivity extends AppCompatActivity { 


@override 
pro ote cte gy er ate(Bu ee sa Yealns tanceState) { 
upe ner elsa vedIns a ES te); 
etcon te Rev ievtg.1 ayout . ond_layout); 
i tent inte Fe en te ente) 
String 生计 .ge etstr ingEx xtra("extra_data"); 
Log.d("Sec oj 多 全 Ot data); 


首先 可 以 通过 getIntent() 方 法 获取 到 用 于 启动 SecondActivity 的 Intent， 
eR 传 入 相应 的 键 值 ， 就 可 以 得 到 传递 的 
数据 了 。 这 里 由 于 我 们 传递 的 是 字符 串 ， 所 以 使 用 getstringExtra() 方 


法 来 获取 传递 的 数据 。 如 果 传 递 的 是 整 型 数据 ， 则 使 用 getIntExtra( ) 
方法 ;如 果 传 递 的 是 布尔 型 数据 ， 则 使 用 getBooleanExtra() 方 法 ， 以 此 


类 推 。 


重新 运行 程序 ， 在 FirstActivity 的 界面 点 击 一 下 按钮 会 跳 转 到 
SecondActivity， 查 看 logcat 打 印信 息 ， 如 图 2.20 所 示 。 


Debug 图 Q y 


com. example. activitytest D/SecondActivity: Hello SecondActivity 








图 2.20 SecondActivity 中 的 打印 信息 


可 以 看 到 ， 我 们 在 SecondActivity 中 成 功 得 到 了 从 FirstActivity 传 递 过 来 
的 数据 。 


2.3.5 ”返回 数据 给 上 一 个 活动 


既然 可 以 传递 数据 给 下 一 个 活动 ， 那 么 能 不 能 够 返回 数据 给 上 一 个 活动 
呢 ? 答案 是 肯定 的 。 不 过 不 同 的 是 ， 返 回 上 一 个 活动 只 需要 按 一 下 Back 
键 束 可 以 了 ， 并 没有 一 个 用 于 局 动 活动 的 Intent 来 传递 数据 。 通 过 查阅 
文档 你 会 发 现 ，Activity 中 还 有 一 个 startActivityForResult() 方 法 也 是 
用 于 局 动 活动 的 ， 但 这 个 方法 期 望 在 活动 销毁 的 时 候 能 够 返回 一 个 结果 
给 上 一 个 活动 。 旦 无 疑问 ， 这 就 是 我 们 所 需要 的 。 


startActivityForResult() 方 法 接收 两 个 参数 ， 第 一 个 参数 还 是 Intent， 
第 二 个 参数 是 请 求 码 ， 用 于 在 之 后 的 回调 中 判断 数据 的 来 源 。 我 们 还 是 
来 实战 一 下 ， 修 改 FirstActivity 中 按钮 的 点 击 事 件 ， 代 码 如 下 所 示 : 


button1l.setonCclickListener(new View.OnClickListener() { 














verride 
public void onClick(View v) { 
Intent intent = new Intent(FirstActivity.this, SecondActivity.class); 
startActivityForResult(intent, 1); 
了 
了 ) 


这 里 我 们 使 用 了 startActivityForResult() 方 法 来 启动 SecondActivity， 
请 求 码 只 要 是 一 个 唯一 值 就 可 以 了 ， 这 里 传 入 了 1。 接 下 来 我 们 在 
SecondActivity 中 给 按钮 注册 点 击 事件 ， 并 在 点 击 事件 中 添加 返回 数据 
的 逻辑 ， 代 码 如 下 所 示 : 


public class SecondActivity extends AppCompatActivity { 


Q@override 
protected void onCreate(Bundle SavedInstanceState) { 
Super .oncCcreate(SavedInstanceState) 
setContentView(R.1layout.second_layout 
Button button2 = (Button) FIndViedByid Rid. Dutton 2); 
button2.setonClickListener(new View.OnClickListener() { 
@override 
public void onClick(View v) { 
Intent intent = new Intent() 
intent.putExtra("data_return", "Hello FirstActivity"); 
setResult (RESULT_OK, intent); 
finish(); 


可 以 看 到 ， 我 们 还 是 构建 了 一 个 Intent， 只 不 过 这 个 Intent 仅 仅 是 用 于 传 
递 数据 而 已 ， 它 没有 指定 任何 的 “意图 ”。 紧 接着 把 要 传递 的 数据 存放 在 
Itent 中 ， 然 后 调用 了 setResult() 方 法 。 这 个 方法 非常 重要 ， 是 专门 用 
J 个 活动 返回 数据 的 。 setResult () 方 法 接收 两 个 参数 ， 第 一 个 
参数 用 于 向 上 一 个 活动 返回 处 理 结果 ， 一 般 只 使 用 RESULT_oK 

或 RESULT_CANCELED 这 两 个 值 ， 第 二 个 参数 则 把 带 有 数据 的 Intent 传 递 回 
去 ， 然 后 调用 了 finish() 方 法 来 销毁 当前 活动 。 


由 于 我 们 是 使 用 startActivityForResult() 方 法 来 启动 SecondActivity 
的 ， 在 SecondActivity 被 销毁 之 后 会 回调 上 一 个 活动 的 
onActivityResult() 方 法 ， 因 此 我 们 需要 在 FirstActivity 中 重 写 这 个 方法 
来 得 到 返回 的 数据 ， 如 下 所 示 : 


@Override 
protected void onActivityResult(int requestCode, int resultCode, Intent data) { 
switch (requestCode) { 
GASH. 
if (resultCode == RESULT_OK) { 
String returnedData = data. et ‘data_return"); 
Log.d("FirstActivity", returnedDa 

















break; 
default: 


onActivityResult() 方 法 带 有 三 个 参数 ， 第 一 个 参数 requestcode， 和 
们 在 启动 活动 时 传 入 的 请 求 码 。 第 二 个 参数 resultcode， 即 我 们 在 返 
数据 时 传 入 的 处 理 结果 。 第 三 个 参数 data， 即 携带 着 返回 数据 的 
Intent。 由 于 在 一 个 活动 中 有 可 能 调用 startActivityForResult() 方 法 去 
启动 很 多 不 同 的 活动 ， 每 一 个 活动 返回 的 数据 都 会 回调 

到 JonActivityResult() 这 个 方法 中 ， 因 此 我 们 首先 要 做 的 就 是 通过 检查 
requestcode 的 全 来 判断 数据 来 源 。 确 定数 据 大 从 SecondActivity 返 加 的 
之 后 ， 我 们 再 通过 resultcode 的 值 来 判断 处 理 结 果 是 否 成 功 。 最 后 从 








data 中 取 值 并 打印 出 来 ， 这 样 束 完成 了 同上 一 个 活动 返回 数据 的 工作 。 


重新 运行 程序 ， 在 FirstActivity 的 界面 点 击 投 钮 会 打开 SecondActivity， 
然后 在 oeron oy 点 击 Button 2 按钮 会 回 到 FirstActivity， 这 时 查 
看 logcat 的 打印 信息 ， 如 图 2.21 所 示 。 


Debug 图 Q - 


com. example. activitytest D/FirstActivity: Hello FirstActivity 








图 2.21 FirstActivity 中 的 打印 信息 
可 以 看 到 ，SecondActivity 已 经 成 功 返 回 数据 给 FirstActivity 了 了。 


这 时 候 你 可 能 会 问 ， A de dn 
钮 ， 而 是 通 过 按 下 Back 键 回 到 FirstActivity， 这 样 数据 不 就 没 法 返回 了 
吗 ? 没 错 ， 不 过 这 种 情况 还 是 很 好 处 理 的 ， 我 们 可 以 通过 三 
SecondActivity 中 重 写 写 onBackPressed() 方 法 来 解决 这 个 问题 ， 代 码 如 下 
所 示 : 


@override 
public v wo id Se es te { 
ee 





tent(); 
nte 证 Dt "da . 3 "Hello FirstActivity"); 
etRes ES OK, intent); 
finish(); 


这 样 的 话 ， 当 用 户 按 下 Back 键 ， 就 会 去 执行 onBackPressed() 方 法 中 的 
代码 ， 我 们 在 这 里 添加 返回 数据 的 逻辑 就 行 了 。 





2.4 活动 的 生命 周期 


掌握 活动 的 生命 周期 对 任何 Android 开 发 者 来 说 都 非常 重要 ， 当 你 深入 

理解 活动 的 生命 周期 之 后 ， 束 可 以 与 出 更 加 连贯 流畅 的 程序 ， 并 在 如 何 

人 
户 体 内 。 


2.4.1 返回 栈 
经 过 前 面 几 节 的 学 习 ， 我 相信 你 已 经 发 现 了 这 一 点 ，Android 中 的 活动 


是 可 以 层 登 的 。 我 们 每 局 动 一 个 新 的 活动 ， 就 会 履 盖 在原 活 动 之 上 ， 然 
人 














其 实 Android 是 使 用 任务 〈Task) 来 管理 活动 的 ， 一 个 任务 就 是 一 组 存 
放 在 栈 里 的 活动 的 集合 ， 这 个 栈 也 被 称 作 返 回 栈 (Back Stack) 。 栈 是 
一 种 后 进 先 出 的 数据 结构 ， 在 默认 情况 下 ， 每 当 我 们 启动 了 一 个 新 的 活 
动 ， 它 会 在 返回 栈 中 入 栈 ， 并 处 于 栈 顶 的 位 置 。 而 每 当 我 们 按 下 Back 键 
或 调用 finish() 方 法 去 销毁 一 个 活动 时 ， 处 于 栈 顶 的 活动 会 出 栈 ， 这 时 
前 一 个 入 栈 的 活动 就 会 重新 处 于 栈 顶 的 位 置 。 系 统 思 是 会 显示 处 于 栈 顶 
的 活动 给 用 户 。 


示意 图 2.22 展 示 了 返回 栈 是 如 何 管理 活动 入 栈 出 栈 操作 的 。 





















局 动 的 活动 


返回 栈 





图 2.22 返回 栈 工作 示意 图 
2.4.2 ”活动 状态 


每 个 活动 在 其 生命 周期 中 最 多 可 能 会 有 4 种 状态 。 


/一 


1. 运行 状态 
当 


一 个 活动 位 于 返回 栈 的 栈 顶 时 ， 这 时 活动 就 处 于 运行 状态 。 系 统 

最 不 愿意 回收 的 就 是 处 于 运行 状态 的 活动 ， 因 为 这 会 市 来 非常 过 的 
用 户 体验 。 
2. 暂停 状态 


当 一 个 活动 不 再 处 于 栈 顶 位 置 ， 但 仍然 可 见 时 ， 这 时 活动 就 进入 了 
暂停 状态 。 你 可 能 会 觉得 既然 活动 已 经 不 在 栈 顶 了 ， 还 怎么 会 可 见 


呢 ? 这 是 因为 并 不 是 每 一 个 活动 都 会 占 满 整 个 屏幕 的 ， 比 如 对 话 杠 
形 陈 的 活动 只 会 局 用 屏 医 中 间 的 部 分 区 域 ， 你 很 饼 融 会 在 后 面 看 到 
这 种 活动 。 处 于 暂停 状态 的 活动 仍然 是 完全 存活 独 的 ， 系 统 也 不 愿 
意 去 回收 这 种 活动 〈 因 为 它 还 是 可 见 的 ， 回 收 可 见 的 东西 都 会 在 用 
户 体验 方面 有 不 好 的 影响 ) ， 只 有 在 内 存 极 低 的 情况 下 ， 系 统 才 会 
去 考虑 回收 这 种 活动 。 


3. 停止 状态 
当 一 个 活动 不 再 处 于 栈 顶 位 置 ， 并 且 完 全 不 可 见 的 时 候 ， 就 进入 了 
停止 状态 。 系 统 仍 然 会 为 这 种 活动 保存 相应 的 状态 和 成 员 变量 ， 但 
是 这 并 不 是 完全 可 靠 的 ， 当 其 他 地 方 需要 内 存 时 ， 处 于 停止 状态 的 
活动 有 可 能 会 被 系统 回收 。 

4. 销毁 状态 


当 一 个 活动 从 返回 栈 中 移 除 后 就 变 成 了 销毁 状态 。 系 统 会 最 倾 问 于 
回收 处 于 这 种 状态 的 活动 ， 从 而 保证 手机 的 内 存 充 足 。 


2.4.3 活动 的 生存 期 


Activity 类 中 定义 了 7 个 回调 方法 ， 履 盖 了 活动 生命 周期 的 每 一 个 环 市， 
下 面 就 来 一 一 介绍 这 7 个 方法 。 














。 oncreate()。 这 个 方法 你 已 经 看 到 过 很 多 次 了 ， 每 个 活动 中 我 们 都 
重 写 了 这 个 方法 ， 它 会 在 活动 第 一 次 被 创建 的 时 候 调 用 。 你 应 该 在 
这 个 方法 中 完成 活动 的 初始 化 操作 ， 比 如 说 加 载 布 局 、 定 事件 











。 onstart()。 这 个 方法 在 活动 由 不 可 见 变 为 可 见 的 时 候 调 用 。 


。 onResume() 。 这 个 方法 在 活动 准备 好 和 用 户 进行 交互 的 时 候 调用 。 
此 时 的 活动 一 定位 于 返回 栈 的 栈 项 ， 并 且 处 于 运行 状态 。 


。 onPause()。 这 个 方法 在 系统 准备 去 启动 或 者 恢复 男 一 个 活动 的 时 
候 调 用 。 我 们 通常 会 在 这 个 方法 中 将 一 些 消耗 CPU 的 资源 释放 掉 ， 
以 及 保存 一 些 关 键 数据 ， 但 这 个 方法 的 执行 速度 一 定 要 快 ， 不 然 会 











影响 到 新 的 栈 顶 活动 的 使 用 。 


onstop()。 这 个 方法 在 活动 完全 不 可 见 的 时 候 调用 。 它 和 onPause() 
方法 的 主要 区 别 在 于 ， 如 果 启 动 的 新 活动 是 一 个 对 话 框 式 的 活动 ， 
那么 onPause() 方 法 会 得 到 执行 ， 而 onstop() 方 法 并 不 会 执行 。 


onDestroy() 。 这 个 方法 在 活动 被 销毁 之 前 调用 ， 之 后 活动 的 状态 
将 变 为 销毁 状态 。 

onRestart()。 这 个 方 法 在 活动 由 停止 状态 变 为 运行 状态 之 前 调 
用 ， 也 就 是 活动 被 重新 启动 了 。 











以 上 7 个 方法 中 除了 onRestart() 方 法 ， 其 他 都 是 两 两 相对 的 ， 从 而 又 可 
以 将 活动 分 为 3 种 生存 期 。 


完整 生存 期 。 活 动 在 oncreate() 方 法 和 onDpestroy() 方 法 之 间 所 经 历 
的 ， 束 是 完整 生存 期 。 一 般 情 况 下 ， 一 个 活动 会 在 oncreate() 方 法 
中 完成 各 种 初始 化 操作 ， 而 在 onpestroy() 方 法 中 完成 释放 内 存 的 
操作 。 

可 见 生 存 期 。 活 动 在 onstart() 方 法 和 onstop() 方 法 之 间 所 经 历 

的 ， 就 是 可 见 生存 期 。 在 可 见 生 存 期 内 ， 活 动 对 于 用 户 总 是 可 见 
的 ， 即 便 有 可 能 无 法 和 用 户 进行 交互 。 我 们 可 以 通过 这 两 个 方法 ， 
合理 地 管理 那些 对 用 户 可 见 的 资源 。 比 如 在 onstart() 方 法 中 对 资 
源 进行 加 载 ， 而 在 onstop() 方 法 中 对 资源 进行 释放 ， 从 而 保证 处 于 
停止 状态 的 活动 不 会 占用 过 多 内 存 。 


前 台 生 存 期 。 活 动 在 onResume() 方 法 和 onPause() 方 法 之 间 所 经 历 
的 就 是 前 台 生 存 期 。 在 前 台 生 存 期 内 ， 活 动 总 是 处 于 运行 状态 的 ， 
此 时 的 活动 是 可 以 和 用 户 进行 交互 的 ， 我 们 平时 看 到 和 接触 最 多 的 
也 就 是 这 个 状态 下 的 活动 。 








为 了 帮助 你 能 够 更 好 地 理解 ，Android 官 方 提供 了 一 张 活 动 生命 周期 的 
示意 图 ， 如 图 2.23 所 示 。 
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图 2.23 活动 的 生命 周期 
2.4.4 体验 活动 的 生命 周期 


讲 了 这 么 多 理论 知识 ， 也 是 时 候 该 实战 一 下 了 ， 下 面 我 们 将 通过 一 个 实 
例 ， 让 你 可 以 更 加 直观 地 体验 活动 的 生命 周期 。 


这 次 我 们 不 准备 在 ActivityTest 这 个 项 目的 基础 上 修改 了 ， 而 是 新 建 一 个 
项 目 。 因 此 ， 首 先 关 闭 ActivityTest 项 目 ， 点 击 导 航 栏 File ~ Close 
Project。 然 后 再 新 建 一 个 ActivityLifeCycleTest 项 目 ， 新 建 项 目的 过 程 你 
应 该 已 经 非常 清楚 了 ， 不 需要 我 再 进行 痪 述 ， 这 次 我 们 允许 Android 
Studio 帮 我 们 自动 创建 活动 和 布局 ， 这 样 可 以 省 去 不 少 工作 ， 创 建 的 活 
动 名 和 布局 名 都 使 用 默认 值 。 


这 样 主 活动 就 创建 完成 了 ， 我 们 还 需要 分 别 再 创建 两 个 子 活 动 
NormalActivity 和 DialogActivity， 下 面 一 步 步 来 实现 。 

















右 击 com.example.activitylifecycletest 包 ,New Activity ~ Empty 
Activity， 新 建 NormalActivity， 布 局 起 名 为 normal_layout。 然 后 使 用 同 
样 的 方式 创建 DialogActivity， 布 局 起 名 为 dialog_layout。 


现在 编辑 normal_layout.xml 文 件 ， 将 里 面 的 代码 蔡 换 成 如 下 内 容 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<TextView 
android:layout_width="match_parent" 


android:layout_height="wrap_content" 
android:text="This is a normal activity" 


</LinearLayout> 


这 个 布局 中 我 们 就 非常 简单 地 使 用 了 一 个 TextView， 用 于 显示 一 行文 
字 ， 在 下 一 章 中 你 将 会 学 到 更 多 关于 TextView 的 用 法 。 


然后 再 编辑 dialog_layout.xzml 文 件 ， 将 里 面 的 代码 蔡 换 成 如 下 内 容 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<TextView 
android:layout_width="match_parent" 


android:layout_height="wrap_content" 
android:text="This is a dialog activity" 


</LinearLayout> 


两 个 布局 文件 的 代码 几乎 没有 区 别 ， 只 是 显示 的 文字 不 同 而 已 。 


NormalActivity 和 DialogActivity 中 的 代码 我 们 保持 默认 就 好 ， 不 需要 改 
动 。 


其 实 从 名 字 上 你 就 可 以 看 出 ， 这 两 个 活动 一 个 是 普通 的 活动 ， 一 个 是 对 
话 框 式 的 活动 。 可 是 我 们 并 没有 修改 活动 的 任何 代码 ， 两 个 活动 的 代码 
应 该 几乎 是 一 模 一 样 的 ， 在 哪里 有 体现 出 将 活动 设 成 对 话 框 式 的 呢 ? 别 
着 急 ， 下 面 我 们 马上 开始 设置 。 修 改 AndroidManifest.xml 的 <activity> 
标签 的 配置 ， 如 下 所 示 : 


<activity android:name=".NormalActivity"> 

</activity> 

<activity android:name=".DialogActivity" 
android:theme="@style/Theme.AppCompat .Dialog"> 

</activity> 





这 里 是 两 个 活动 的 注册 代码 ， 但 是 DialogActivity 的 代码 有 些 不 同 ， 我 们 
给 它 使 用 了 一 个 android:theme 属 性 ， 这 是 用 于 给 当前 活动 指定 主题 

的 ，Android 系 统 内 置 有 很 多 主题 可 以 选择 ， 当 然 我 们 也 可 以 定制 自己 
的 主题 ， 而 这 里 @style/Theme.Appcompat .Dialog 则 毫 无 疑问 是 让 
DialogActivity 使 用 对 话 框 式 的 主题 。 


接 下 来 我 们 修改 activity_main.xml， 重 新 定制 主 活 动 的 布局 ， 将 里 面 的 
代码 蔡 换 成 如 下 内 容 : 


<LinearLayout xmlns: android= ss //schemas.android.com/apk/res/android" 
android:orientation="verti 
android:layout_width= wa i 
android:layout_height="match_parent"> 











<Button 
android:id="@+id/start_normal activity" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Start NormalActivity" /> 


<Button 
android:id="@+id/start_dialog activity" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Start DialogActivity" /> 


</LinearLayout> 


可 以 看 到 ， 我 们 在 LinearLayout 中 加 入 了 两 个 按钮 ， 一 个 用 于 局 动 
NormalActivity， 一 个 用 于 启动 DialogActivity。 


最 后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
public static final String TAG = "MainActivity"; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
Log.d(TAG, "onCreate"); 
setContentView(R.1layout.activity main); 
Button startNormalActivity = (Button) findViewById(R.id.start_ normal_ 
activity); 
Button startDialogActivity = (Button) findViewById(R.id.start dialog_ 
activity); 
startNormalActivity.setonclickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
Intent intent = new Intent(MainActivity.this, NormalActivity.class); 
startActivity(intent); 


} 

}); 

startDialogActivity.setoncClickListener(new View.OnClickListener() { 
@override 


public void onClick(View v) { 
Intent intent = new Intent(MainActivity.this, DialogActivity.class); 
startActivity(intent); 





}); 
} 


@Override 

protected void onStart() { 
super .onstart(); 
Log.d(TAG, "onStart") ; 


Q@override 

protected void onResume() { 
Super .onResume( ); 
Log.d(TAG, "onResume"); 


@Override 

protected void onPause() { 
super .onpPause(); 
Log.d(TAG, "onPause"); 


@Override 

protected void onStop() { 
super .onstop(); 
Log.d(TAG, "onSstop"); 


@override 

protected void onDestroy() { 
super .onDestroy(); 
Log.d(TAG, "onDestroy"); 


@Ooverride 

protected void onRestart() { 
super .onRestart(); 
Log.d(TAG, "onRestart"); 

} 


在 oncreate() 方 法 中 ， 我 们 分 别 为 两 个 按钮 注册 了 点 击 事件 ， 点 击 第 一 
个 按钮 会 局 动 NormalActivity， 点 击 第 二 个 按钮 会 月 动 DialogActivity。 
然后 在 Activity 的 7 个 回调 方法 中 分 别 打 印 了 一 句 话 ， 这 样 就 可 以 通过 观 
察 日 志 的 方式 来 更 直观 地 理解 活动 的 生命 周期 。 








现在 运行 程序 ， 效 果 如 图 2.24 所 示 。 


ActivityLifeCycleTest 


START NORMALACTIVITY 


START DIALOGACTIVITY 








图 2.24 MainActivity 界 面 


这 时 观察 logcat 中 的 打印 日 志 ， 如 图 2.25 所 示 。 
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com. example. activitylifecycletest D/MainActivity: onCreate 
com. example. activitylifecycletest D/MainActivity: onStart 


com. example. activitylifecycletest D/MainActivity: onResume 


图 2.25 启动 程序 时 的 打印 日 志 
可 以 看 到 ， 当 MainActivity 第 一 次 被 创建 时 会 依次 执 


行 oncreate()、onstart() 和 onResume() 方 法 。 然 后 点 击 第 一 个 按钮 ， 局 
动 NormalActivity， 如 图 2.26 所 示 。 


ActivityLifeCycleTest 








图 2.26 NormalActivity 界 面 


此 时 的 打印 信息 如 图 2.27 所 示 。 





Verbose 图 CV 


com. example. activitylifecycletest D/MainActivity: onPause 





com. example. activitylifecycletest D/MainActivity: onStop 


图 2.27 打开 NormalActivity 时 的 打印 日 志 





由 于 NormalActivity 已 经 把 MainActivity 完 全 遮挡 住 ， 因 此 onPause() 和 


onstop() 方 法 都 会 得 到 执行 。 然 后 按 下 Back 键 返回 MainActivity， 
信息 如 图 2.28 所 示 。 


打印 





| Verbose 国 (Q: 





com. example. activitylifecycletest D/MainActivity: onRestart 
com. example. activitylifecycletest D/MainActivity: onStart 


com. example. activitylifecycletest D/MainActivity: onResume 


图 2.28 返回 MainActivity 的 打印 日 志 


由 于 之 前 MainActivity 已 经 进入 了 停止 状态 ， 所 以 onRestart() 方 法 会 得 
到 执行 ， 之 后 又 会 依次 执行 onstart() 和 onResume( 1) 方法。 注意 此 时 


oncreate() 方 法 不 会 执行 ， 因 为 MainActivity 并 没有 重新 创建 。 


然后 再 点 击 第 二 个 按钮 ， 启 动 DialogActivity， 如 图 2.29 所 示 。 


ActivityLifeCycleTest 





图 2.29 ”DialogActivity 界 面 
此 时 观察 打印 信息 ， 如 图 2.30 所 示 。 


| Verbose 图 (ey ) 








com. example. activitylifecycletest D/MainActivity: onPause 


图 2.30 打开 DialogActivity 时 的 打印 日 志 


可 以 看 到 ， 只 有 onPause() 方 法 得 到 了 执行 ，onstop() 方 法 并 没有 执行 ， 
这 是 因为 DialogActivity 并 没有 完全 遮挡 住 MainActivity， 此 时 
MainActivity 只 是 进入 了 和 暂停 状态 ， 并 没有 进入 停止 状态 。 相 应 地 ， 按 
下 Back 键 返回 MainActivity 也 应 该 只 有 onResume() 方 法 会 得 到 执行 ， 如 
图 2.31 所 示 。 





Verbose 图 (Qr 


com. example. activitylifecycletest D/MainActivity: onResume 





图 2.31 再 次 返回 MainActivity 的 打印 日 志 
最 后 在 MainActivity 按 下 Back 键 退出 程序 ， 打 印信 息 如 图 2.32 所 示 。 


Verbose 图 (Q: 


com. example. activitylifecycletest D/MainActivity: onPause 








com. example. activitylifecycletest D/MainActivity: onStop 


com. example. activitylifecycletest D/MainActivity: onDestroy 


图 2.32 退出 程序 时 的 打印 日 志 


依次 会 执行 onPause()、onstop() 和 onpestroy() 方 法 ， 最 终 销 毁 
MainActivity。 


这 样 活动 完整 的 生命 周期 你 已 经 体验 了 一 过， 是 不 是 理解 得 更 加 深刻 
了 了? 


2.4.5 活动 被 回收 了 怎么 办 


前 面 我 们 已 经 说 过 ， 当 一 个 活动 进入 到 了 停止 状态 ， 是 有 可 能 被 系统 回 
收 的 。 那 么 想象 以 下 场景 : 应 用 中 有 一 个 活动 A， 用 户 在 活动 A 的 基础 
上 启动 了 活动 B， 活 动 A 就 进入 了 停止 状态 ， 这 个 时 候 由 于 系统 内 存 不 
足 ， We i hk 然后 用 户 按 下 Back 键 返回 活动 A， 会 出 现 什 么 
情况 呢 ?” 其 实 还 是 会 正常 显示 活动 A 的 ， 只 不 过 这 时 并 不 会 执 

行 onRestart() 方 法 ， 而 是 会 执行 活动 A 的 oncreate( ) 方 法 ， 因 为 活动 A 
在 这 种 情况 下 会 被 重新 创建 一 次 。 


这 样 看 上 去 好 像 一 切 正常 ， 可 是 别 急 略 了 一 个 重要 问题 ， 活 动 A 中 是 可 
能 存在 临时 数据 和 状态 的 。 打 个 比方 ，MainActivity 中 有 一 个 文本 输入 
框 ， 现 在 你 输入 了 一 段 文字 ， 然 后 启动 NormalActivity， 这 时 
MainActivity 由 于 系统 内 存 不 足 被 回收 挥 ， 过 了 一 会 你 又 点 击 了 Back 键 
回 到 MainActivity， 你 会 发 现 刚 刚 输入 的 文字 全 部 都 没 了 ， 因 为 














MainActivity 被 重新 创建 了 。 


如 果 我 们 的 应 用 出 现 了 这 种 情况 ， 是 会 严重 影 啊 用 户 体验 的 ， 所 以 必须 
要 想 想 办 法 解决 这 个 问题 。 EN 
个 onsaveInstanceState() 回调 方法 ， 这 个 方法 可 以 保证 在 活动 被 回收 之 
前 一 定 会 被 调用 ， 因 此 我 们 可 以 通过 这 个 方法 来 解决 活动 被 回收 时 临时 
数据 得 不 到 保存 的 问题 。 


onSaveInstanceState() 方 法 会 携带 一 个 Bundle 类 型 的 参数 ，Bundle 提 供 
了 一 系列 的 方法 用 于 保存 数 鼎 ， 比 如 可 以 使 用 putstring() 方 法 保存 这 
符 串 ， 使 用 putInt() 方 法 保存 整 型 数据 ， 以 此 类 推 。 每 个 保存 方法 需 
传 入 邱 个 参数 ， 第 一 个 参数 是 键 ， 用 于 后 面 从 sundie 中 取 值 ， 第 一 个 参 

数 是 真正 要 保存 的 内 容 。 


在 MainActivity 中 添加 如 下 代码 残 可 以 将 临时 数据 进行 保存 : 





@ove 
pro ote ets dv oad onSaveInstanceState(Bundle outState) { 


pe veIns ee Ea 人 
str 3 ma ata mething yo Lu st typed"; 
utState.putStr ing( 29 ta_key", tempData); 
} 





数据 是 已 经 保存 下 来 了 ， 那 么 我 们 应 该 在 哪里 进行 恢复 呢 ?” 细 心 的 你 也 

许 早 就 发 现 ， 我 们 一 直 使 用 的 oncreate() 方 法 其 实 也 有 一 个 Bundle 类 型 

的 参数 。 这 个 参数 在 一 般 情况 下 都 是 nu11， 但 是 如 果 在 活动 被 系统 回收 

之 前 有 通过 onsaveInstanceState() 方 法 来 保存 数据 的 话 ， 这 个 参数 束 会 

0 我 们 只 需要 再 通过 相应 的 取 值 方法 将 数据 
即 可 。 


修改 MainActivity 的 oncreate() 方 法 ， 如 下 所 示 : 





@override 
protected void onCreate(Bun a Santee tae) { 
和 ie CS vedTn sta cestate); 


String tempData = savedIns tanceState.getSstring("data_key"); 
Log.d(TAG, tempData); 
} 





取出 值 之 后 再 做 相应 的 恢复 操作 就 可 以 了 ， 比 如 说 将 文本 内 容重 新 赋值 
到 文本 输入 框 上 ， 这 里 我 们 只 是 简单 地 打印 一 下 。 





不 知道 你 有 没有 察觉 ， 使 用 Bundle 来 保存 和 取出 数据 是 不 是 有 些 似 曾 相 
识 昵 ? 没 错 ! 我 们 在 使 用 Intent 传 递 数据 时 也 是 用 的 类 似 的 方法 。 这 里 
跟 你 提醒 一 点 ，Ptent 还 可 以 结合 Bundle 一 起 用 于 传递 数据 ， 首 先 可 以 
把 需要 传递 的 数据 都 保存 在 Bundle 对 象 中 ， 然 后 再 将 Bundle 对 象 存放 在 
Intent 里 。 到 了 目标 活动 之 后 先 从 Intent 中 取出 Bundle， 再 从 Bundle 中 一 
一 取出 数据 。 具 体 的 代码 我 束 不 写 了 ， 要 学 会 举一反三 哦 。 











2.5 ”活动 的 局 动 柑 式 


活动 的 局 动 模式 对 你 来 说 应 该 是 个 全 新 的 概念 ， 在 实际 项 目 中 我 们 应 该 
根据 特定 的 需求 为 每 个 活动 指 ; 定 恰当 的 启动 模式 。 局 动 模式 一 共有 4 
种 ， 分 别 是 standard、singleTop、singleTask 和 singleInstance， 可 以 在 
AndroidManifest.xml 中 通过 给 <activity> 标 签 指定 android:launchMode 属 


性 来 选择 启动 模式 。 下 面 我 们 来 逐个 进行 学 习 。 
2.5.1 standard 


standard 是 活动 默认 的 启动 模式 ， 在 不 进行 显 式 指定 的 情况 下 ， 所 有 活 
动 都 会 自动 使 用 这 种 启动 模式 。 因 此 ， 到 目前 为 止 我 们 写 过 的 所 有 活动 
都 是 使 用 的 standard 模 式 。 经 过 上 一 节 的 学 习 ， 你 已 经 知道 了 Android 是 
使 用 返回 栈 来 管理 活动 的 ， 在 standard 模 式 〈 即 默认 情况 ) 下 ， 每 当 启 
动 一 个 新 的 活动 ， 它 就 会 在 返回 栈 中 入 栈 ， 并 处 于 栈 顶 的 位 置 。 对 于 使 
用 standard 模 式 的 活动 ， 系 统 不 会 在 乎 这 个 活动 是 否 已 经 在 返回 栈 中 存 
在 ， 每 次 启动 都 会 创建 该 活动 的 一 个 新 的 实例 。 

我 们 现在 通过 实践 来 体会 一 下 standard 模 式 ， 这 次 还 是 准备 在 
ActivityTest 项 目的 基础 上 修改 ， 首 先 关 闭 ActivityLifeCycleTest 项 目 ， 打 
开 ActivityTest 项 目 。 


修改 FirstActivity 中 oncreate() 方 法 的 代码 ， 如 下 所 示 : 
































@override 
protected void onCreate(Bundle sa vedinstanceState) { 


t); 
Button by tt = (Button) findVi SWBy A(R n_1); 
buttonl . 二 0 ni ckListener(new er(){ 


@override 

pu ublic void onClic SR ew vV) { 
Intent et new Intent(FirstActivity.this, FirstActivity.class); 
startActivity(intent); 

} 


代码 看 起 来 有 些 奇怪 吧 ， 在 FirstActivity 的 基础 上 启动 FirstActivity。 从 
逻辑 上 来 讲 这 确实 没什么 音义， 不 过 我 们 的 重点 在 于 研究 standard 模 
式 ， 因 此 不 必 在 意 这 段 代码 有 什么 实际 用 途 。 男 外 我 们 还 在 oncreate() 





方法 中 添加 了 一 行 打印 信息 ， 用 于 打印 当前 活动 的 实例 。 


现在 重新 运行 程序 ， 然 后 在 FirstActivity 界 面 连 续 点 击 两 次 按钮 ， 可 以 看 
到 logcat 中 打印 信息 如 图 2.33 所 示 。 





Debug 图 Qr ) Regex | FirstActivity 


com. example. activitytest D/FirstActivity: com. example. activitytest.FirstActivity@71b88c5 
com. example. activitytest D/FirstActivity: com. example.activitytest. FirstActivity@37b39291 
Com. example. activitytest D/FirstActivity: com. example.activitytest.FirstActivity@20309892 


图 2.33 standard 模 式 下 的 打印 日 志 

从 打印 信息 中 我 们 就 可 以 看 出 ， 每 点 击 一 次 按钮 就 会 创建 出 一 个 新 的 
FirstActivity 实 例 。 此 时 返回 栈 中 也 会 存在 3 个 FirstActivity 的 实例 ， 因 此 
你 需要 连 按 3 次 Back 键 才能 退出 程序 。 


standard 模 式 的 原理 示意 图 ， 如 图 2.34 所 示 。 





局 动 新 活动 


启动 新 活动 





返回 栈 


图 2.34 standard 模 式 示意 图 


2.5.2 SingleTop 


可 能 在 有 些 情况 下 ， 你 会 觉得 standard 模 式 不 太 合理 。 活 动 明 明 已 经 在 
栈 顶 了 ， 为 什么 再 次 启动 的 时 候 还 要 创建 一 个 新 的 活动 实例 呢 ? 别 着 
乱 ， 这 只 是 系统 默认 的 一 种 局 动 模式 而 已 ， 你 完全 可 以 根据 上 自己 的 需要 
进行 修改 ， 比 如 说 使 用 singleTop 模 式 。 当 活动 的 启动 模式 指定 为 
singleTop， 在 启动 活动 时 如 果 友 现 返 回 栈 的 栈 顶 已 经 是 该 活动 ， 则 认为 
可 以 直接 使 用 它 ， 不 会 再 创建 新 的 活动 实例 。 


我 们 还 是 通过 实践 来 体会 一 下 ， 修 改 AndroidManifest.xml 中 FirstActivity 
的 启动 模式 ， 如 下 所 示 : 











d:name=" .FirstActivity" 
d:launchMode="singleTop" 
id:label="This is FirstActivity"> 
t-fi r> 

cti 


oid:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 

</activity> 





然后 重新 运行 程序 ， 查 看 logcat 会 看 到 已 经 创建 了 一 个 FirstActivity 的 实 
例 ， 如 图 2.35 所 示 。 


Debug 国 el Regex | FirstActivity 


com. example, activitytest D/FirstActivity: com. example.activitytest. FirstActivity@2cd53c9f 
图 2.35 ”singleTop 模 式 下 的 打印 日 志 


但 是 之 后 不 管 你 点 击 多 少 次 按钮 都 不 会 再 有 新 的 打印 信息 出 现 ， 因 为 目 
前 FirstActivity 己 经 处 于 返回 栈 的 栈 顶 ， 每 当 想 要 再 启动 一 个 
FirstActivity 时 都 会 直接 使 用 栈 顶 的 活动 ， 因 此 FirstActivity 也 只 会 有 一 
个 实例 ， 仅 按 一 次 Back 键 就 可 以 退出 程序 。 


不 过 当 FirstActivity 并 未 处 于 栈 顶 位 置 时 ， 这 时 再 启动 FirstActivity， 还 
是 会 创建 新 的 实例 的 。 


下 面 我 们 来 实验 一 下 ， 修改 FirstActivity 中 oncreate() 方 法 的 代码 ， 如 下 
所 示 : 














@override 
protected void onCreate(Bundle SavedInstanceState) { 
super. oncreate(SavedInstanceSta ate); 
Log.d("FirstActivity", this.tostring()); 
setContentView(R. layout .first_layout); 
Button button1 = (Button) findViewById(R.id.button_ 1); 
buttoni1.setOonclickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
Intent intent = new Intent(FirstActivity.this, SecondActivity.class); 
startActivity(intent); 
} 
}); 


这 次 我 们 点 击 按钮 后 启动 的 是 SecondActivity。 然 后 修改 SecondActivity 
中 oncreate() 方 法 的 代码 ， 如 下 所 示 : 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceSstate); 
Log.d("SecondActivity", this.tostring()); 
setContentView(R.1layout.second_ layout); 
Button button2 = (Button) findViewById(R.id.button 2); 
button2.setonCclickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
Intent intent = new Intent(SecondActivity.this, FirstActivity.class); 
startActivity(intent); 
} 
}); 





我 们 在 SecondActivity 中 的 按钮 点 击 事件 里 义 加 入 了 启动 FirstActivity 的 
代码 。 现 在 重新 运行 程序 ， 在 FirstActivity 界 面 点 击 按钮 进入 到 
SecondActivity， 然 后 在 SecondActivity 界 面 点 击 按钮 ， 又 会 重新 进入 到 
FirstActivity 。 


得 看 logcat 中 的 打印 信息 ， 如 图 2.36 所 示 。 








Debug 图 [QvActivity: Regex | Show only 





com. example. activitytest D/FirstActivity: com. example. activitytest. FirstActivity@2cd53c9f 
com. example. activitytest D/SecondActivity: com. example. activitytest. SecondActivity@3c50d14 


com. example. activitytest D/FirstActivity: com. example.activitytest. FirstActivity@215dbad3 


图 2.36 singleTop 模 式 下 的 打印 日 志 


可 以 看 到 系统 创建 了 两 个 不 同 的 FirstActivity 实 例 ， 这 是 由 于 在 
SecondActivity 中 再 次 局 动 FirstActivity 时 ， 栈 顶 活 动 已 经 变 成 了 
SecondActivity， 因 此 会 创建 一 个 新 的 FirstActivity 实 例 。 现 在 按 下 Back 
键 会 返回 到 SecondActivity， 再 次 按 下 Back 键 叉 会 回 到 FirstActivity， 再 
按 一 次 Back 键 才 会 退出 程序 。 


singleTop 模 式 的 原理 示意 图 ， 如 图 2.37 所 示 。 


检查 栈 顶 判 


断 是 否 需 要 


启动 新 活动 
SecondActivity 


启动 新 活动 


返回 栈 


图 2.37 ”singleTop 模 式 示 意图 





2.5.3 singleTask 


使 用 singleTop 模 式 可 以 很 好 地 解决 重复 创建 栈 顶 活动 的 问题 ， 但 是 正如 
你 在 上 一 节 所 看 到 的 ， 如 果 该 活动 并 没有 处 于 栈 顶 的 位 置 ， 还 是 可 能 会 
创建 多 个 活动 实例 的 。 那 么 有 没有 什么 办 法 可 以 让 茶 个 活动 在 整个 应 用 
程序 的 上 下 文中 只 存在 一 个 实例 呢 ? 这 就 要 借助 singleTask 模 式 来 实现 
了 。 当 活动 的 启动 模式 指定 为 singleTask， 每 次 启动 该 活动 时 系统 首先 
会 在 返回 栈 中 检查 是 否 存在 该 活动 的 实例 ， 如 果 发 现 已 经 存在 则 直接 使 
用 该 实例 ， 并 把 在 这 个 活动 之 上 的 所 有 活动 统统 出 栈 ， 如 宁 没 有 发 现 束 
会 创建 一 个 新 的 活动 实例 。 


我 们 还 是 通过 代码 来 更 加 直观 地 理解 一 下 。 修 改 AndroidManifest.xml 中 
FirstActivity 的 启动 模式 : 








er> 

android:name="android.intent.action.MAIN" /> 

ory android:name="android.intent.category.LAUNCHER" /> 
t 


</activity> 


然后 在 FirstActivity 中 添加 onRestart() 方 法 ， 并 打印 日 志 : 


@Override 

protected void onRestart() { 
super .onRestart(); 
Log.d("FirstActivity", "onRestart"); 


最 后 在 SecondActivity 中 添加 onDestroy() 方 法 ， 并 打印 日 志 : 


@Override 

protected void onDestroy() { 
super .onDestroy(); 
Log.d("SecondActivity", "onDestroy"); 





现在 重新 运行 程序 ， 在 FirstActivity 界 面 点 击 按钮 进入 到 
SecondActivity， 然 后 在 SecondActivity 界 面 点 击 按钮 ， 又 会 重新 进入 到 
FirstActivity 。 


查看 logcat 中 的 打印 信息 ， 如 图 2.38 所 示 。 





Debug 图 QrActivity: | Regex | Show only 





com,. example. activitytest D/FirstActivity: com. example. activitytest,FirstActivity@186799b5 
com. example. activitytest D/SecondActivity: com. exXample. activitytest, SecondActivity@3c50d14 
com. example. activitytest D/FirstActivity: onRestart 


com. example. activitytest D/SecondActivity: onDestroy 


图 2.38 ”singleTask 模 式 下 的 打印 日 志 


其 实 从 打印 信息 中 束 可 以 明显 看 出 了 ， 在 SecondActivity 中 启动 
FirstActivity 时 ， 会 发 现 返 回 栈 中 已 经 存在 一 个 FirstActivity 的 实例 ， 并 
且 是 在 SecondActivity 的 下 面 ， 于 是 SecondActivity 会 从 返回 栈 中 出 栈 ， 
而 FirstActivity 重 新 成 为 了 栈 顶 活动 ， 因 此 FirstActivity 的 onRestart() 方 
法 和 SecondActivity 的 onpestroy() 方 法 会 得 到 执行 。 现 在 返回 栈 中 应 该 

只 剩 下 一 个 FirstActivity 的 实例 了 ， 按 一 下 Back 键 束 可 以 退出 程序 。 


singleTask 模 式 的 原理 示意 图 ， 如 图 2.39 所 示 。 


局 动 SecondActivity 


返回 栈 





图 2.39 ”singleTask 模 式 示意 图 
2.5.4 SingleInstance 


singleInstance 模 式 应 该 算是 4 种 启动 模式 中 最 特殊 也 最 复杂 的 一 个 了 ， 

你 也 需要 多 花 点 功夫 来 理解 这 个 模式 。 不 同 于 以 上 3 种 局 动 模式 ， 指 定 

为 singleInstance 模 式 的 活动 会 局 用 一 个 新 的 返回 栈 来 管理 这 个 活动 〈 其 
实 如 果 singleTask 模 式 指 定 了 不 同 的 taskAffinity， 也 会 启动 一 个 新 的 返回 
栈 ) 。 那 么 这 样 做 有 什么 意义 呢 ? 想象 以 下 场景 ， 假 设 我 们 的 程序 中 有 
一 个 活动 是 允许 其 他 程序 调用 的 ， 如 果 我 们 想 实现 其 他 程序 和 我 们 的 程 
序 可 以 共享 这 个 活动 的 实例 ， 应 该 如 何 实现 呢 ? 使 用 前 面 3 种 启动 模式 

肯定 是 做 不 到 的 ， 因 为 每 个 应 用 程序 都 会 有 自己 的 返回 栈 ， 同 一 个 活动 
在 不 同 的 返回 栈 中 入 栈 时 必然 是 创建 了 新 的 实例 。 而 使 用 singleInstance 
模式 就 可 以 解决 这 个 问题 ， 在 这 种 模式 下 会 有 一 个 单独 的 返回 栈 来 管理 
这 个 活动 ， 不 管 是 哪个 应 用 程序 来 访问 这 个 活动 ， 都 共用 的 同一 个 返回 
栈 ， 也 就 解决 了 共享 活动 实例 的 问题 。 








为 了 帮助 你 更 好 地 理解 这 种 启动 模式 ， 我 们 还 是 来 实践 一 下 。 修 改 
AndroidManifest.xml 中 SecondActivity 的 启动 模式 : 


<activity android:name=".SecondActivity" 
android:launchMode="singleInstance"> 
<intent-filter> 
<action android:name="com.example.activitytest.ACTION_START" /> 
<category android:name="android.intent.category.DEFAULT" /> 
<category android:name="com.example.activitytest.MY_CATEGORY" /> 
</intent-filter> 
</activity> 


我 们 先 将 SecondActivity 的 启动 模式 指定 为 singleInstance， 然 后 修改 
FirstActivity 中 oncreate() 方 法 的 代码 : 


@override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
Log.d("FirstActivity", "Task id is " + getTaskId()); 
setContentView(R.1layout.first_layout); 
Button button1l = (Button) findViewById(R.id.button_ 1); 
button1l.setonClickListener(new View.OnClickListener() { 
@Ooverride 
public void onClick(View v) { 
Intent intent = new Intent(FirstActivity.this, SecondActivity.class); 
startActivity(intent); 


}); 


在 oncreate() 方 法 中 打印 了 当前 返回 栈 的 id。 然 后 修改 SecondActivity 中 
onCreate( ) 方 法 的 代码 : 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedIinstanceState); 
Log.d("SecondActivity", "Task id is " + getTaskId()); 
setContentView(R.1layout.second_layout); 
Button button2 = (Button) findViewById(R.id.button 2); 
button2.setonClickListener(new View.OnClickListener() { 
@override 
public void onClick(View v) { 
Intent intent = new Intent(SecondActivity.this, ThirdActivity.class); 
startActivity(intent); 
} 
}); 


同样 在 oncreate() 方 法 中 打印 了 当前 返回 栈 的 id， 然 后 又 修改 了 按钮 点 
击 事件 的 代码 ， 用 于 启动 ThirdActivity。 最 后 修改 ThirdActivity 中 
onCreate( ) 方 法 的 代码 : 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceSstate); 
Log.d("ThirdActivity", "Task id is " + getTaskId()); 
setContentView(R.1layout.third_ layout); 

i 


仍然 是 在 oncreate() 方 法 中 打印 了 当前 返回 栈 的 id。 现 在 重新 运行 程 
序 ， 在 FirstActivity 界 面 点 击 按钮 进入 到 SecondActivity， 然 后 在 
SecondActivity 界 面 点 击 按钮 进入 到 ThirdActivity。 


查看 logcat 中 的 打印 信息 ， 如 图 2.40 所 示 。 





Debug 图 Q rActivity: 





com. example. activitytest D/FirstActivity: Task id is 171 
com. example. activitytest D/SecondActivity: Task id is 172 


com. example. activitytest D/ThirdActivity: Task id is 171 


图 2.40 ”singleInstance 模 式 下 的 打印 日 志 


可 以 看 到 ，SecondActivity 的 Task id 不 同 0 ThirdActivity， 
这 说 0 一 个 单独 的 返回 栈 里 的 ， 而 且 这 个 
栈 中 只 有 SecondActivity 这 一 个 活动 。 


然后 我 们 按 下 Back 键 进行 返回 ， 你 会 及 现 ThirdActivity 葛 然 直接 返回 到 
了 再 按 下 Back 键 又 会 返回 到 SecondActivity， 再 按 下 Back 
键 才 会 退出 程序 ， 这 是 为 什么 呢 ? 其 实 原理 很 简单 ， 由 于 FirstActivity 和 
ThirdActivity 是 存放 在 同一 个 返回 栈 里 的 ， 当 在 ThirdActivity 的 界面 按 下 
Back 键 ，ThirdActivity 会 从 返回 栈 中 出 栈 ， 那 么 FirstActivity 就 成 为 了 栈 
顶 活动 显示 在 界面 上 ， 因 此 也 就 出 现 了 从 ThirdActivity 直 接 返 回 到 
FirstActivity 的 情况 。 然 后 在 FirstActivity 界 面 再 次 按 下 Back 键 ， 这 时 当 
前 的 返回 栈 已 经 宅 了 ， 于 是 就 显示 了 夯 一 个 返回 栈 的 栈 顶 活动 ， 
SecondActivity。 最 后 再 次 按 下 Back 键 ， 这 时 所 有 返回 栈 都 已 经 空 
也 就 自然 退出 了 程序 。 


singleInstance 模 式 的 原理 示意 图 ， 如 图 2.41 所 示 。 











图 2.41 singleInstance 模 式 示意 图 


2.6 ”活动 的 最 佳 实践 


你 已 经 掌握 了 关于 活动 非常 多 的 知识 ， 不 过 恐怕 离 能 够 完全 灵活 运用 还 
有 一 段 距 离 。 虽 然 知识 点 只 有 这 人 么 多 ， 但 运用 的 技巧 却 是 多 种 多 样 的 。 
所 以 ， 在 这 里 我 准备 教 你 几 种 关于 活动 的 最 佳 实践 技巧 ， 这 些 技巧 在 你 
以 后 的 开发 工作 当中 将 会 非常 有 用 。 


2.6.1 ”知晓 当前 是 在 哪 一 个 活动 


这 个 技巧 将 教会 你 如 何 根据 程序 当前 的 界面 就 能 判断 出 这 是 哪 一 个 活 

动 。 可 能 你 会 党 得 挺 纳闷 的 ， 我 目 己 写 的 代码 怎么 会 不 知道 这 是 哪 一 个 
活动 呢 ? 很 不 重 的 是 ， 在 你 真正 进入 到 企业 之 后 ， 更 有 可 能 的 是 接手 一 
份 询 人 与 的 代码 ， 因 为 你 刚 进 公司 惑 正好 有 一 个 新 项 目 启 动 的 概率 并 不 
高 。 了 阅读 别人 的 代码 时 有 一 个 很 头疼 的 问题 ， 束 是 当 你 需要 在 茶 个 界面 
上 修改 一 些 非 第 简单 的 东西 时 ， 却 半天 找 不 到 这 个 界面 对 应 的 活动 是 哪 
一 个 。 学 会 了 本 市 的 技巧 之 后 ， 这 对 你 来 说 就 再 也 不 是 难题 了 。 


我 们 还 是 在 ActivityTest 项 目的 基础 上 修改 ， 首 先 需 要 新 建 一 
个 BaseActivity 类 。 右 击 com.example.activitytest 包 ,New -Java Class， 


在 弹出 的 窗口 出 输入 BaseActivity， 如 图 2.42 所 示 。 
「 两 Be Class “OOOO 


Nome 1 
Kind: Cc) Class 国 



































轩 2 于 | Cancel | 





图 2.42 创建 BaseActivity 类 


注意 这 里 BaseActivity 和 普通 活动 的 创建 方式 并 不 一 样 ， 因 为 我 们 不 需 
要 让 BaseActivity 在 AndroidManifest,xml 中 注册 ， 所 以 选择 创建 一 个 普 
通 的 Java 类 就 可 以 了 。 然 后 让 BaseActivity 继 承 自 AppCompatActivity， 
并 重 写 oncreate() 方 法 ， 如 下 所 示 : 


public class BaseActivity extends AppCompatActivity { 


@override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCcreate(SavedInstanceState) 
Log.d("BaseActivity", getClass().getSsimpleName()); 


0 ) 方 法 中 获取 了 当前 实例 的 类 名 ， 并 通过 Log 打 印 了 出 


接 下 来 我 们 需要 让 BaseActivity 成 为 ActivityTest 项 目 中 所 有 活动 的 父 
类 。 修 改 FirstActivity、SecondActivity 和 ThirdActivity 的 继承 结构 ， 让 它 
们 不 再 继承 自 AppcompatActivity， 而 是 继承 自 BaseActivity。 而 由 于 
BaseActivity 义 是 继承 自 AppCompatActivity 的 ， 所 以 项 目 中 所 有 活动 的 
现 有 功能 并 不 受 影 响 ， 它 们 仍然 完全 继承 了 Activity 中 的 所 有 特性 。 


现在 重新 运行 程序 ， 然 后 通过 点 击 按钮 分 别 进 入 到 FirstActivity、 
SecondActivity 和 ThirdActivity 的 界面 ， 这 时 观察 logcat 中 的 打印 信息 ， 如 
图 2.43 所 示 。 





Debug 图 Q " 


com. example. activitytest D/BaseActivity: FirstActivity 





com. example. activitytest D/BaseActivity: SecondActivity 


com. example. activitytest D/BaseActivity: ThirdActivity 


图 2.43 ”BaseActivity 中 的 打印 日 志 


现在 每 当 我 们 进入 到 一 个 活动 的 界面 ， 该 活动 的 类 名 束 会 被 打印 出 来 ， 
这 样 我 们 束 可 以 时 时 刻 刻 知晓 当前 界面 对 应 的 是 哪 一 个 活动 了 。 


2.6.2 ”随时 随地 退出 程序 


如 果 目 前 你 手机 的 界面 还 停留 在 ThirdActivity， 你 会 发 现 当前 想 退 出 程 
序 是 非常 不 方便 的 ， 需 要 连 按 3 次 Back 键 才 行 。 按 Home 键 只 是 把 程序 挂 
起 ， 并 没有 退出 程序 。 其 实 这 个 问题 就 足以 引起 你 的 思考 ， 如 果 我 们 的 
程序 需要 一 个 注销 或 者 退出 的 功能 该 怎么 办 呢 ?” 必 须要 有 一 个 随时 随地 
都 能 退出 程序 的 方案 才 行 。 





其 实 解决 思路 也 很 简单 ， 只 需要 用 一 个 专门 的 集合 类 对 所 有 的 活动 进行 
管理 就 可 以 了 ， 下 面 我 们 就 来 实现 一 下 。 


新 建 一 个 Activitycollector 类 作为 活动 管理 器 ， 代 码 如 下 所 示 : 


public class ActivityCollector { 





public static List<Activity> activities = new ArrayList<>(); 
public static void addActivity(Activity activity) { 


activities.add(activity); 
9 


public static void removeActivity(Activity activity) { 
activities.remove(activity); 
} 


public static void finishAll() { 
for (Activity activity : activities) { 
if (!activity.isFinishing()) { 
activity.finish() 


} 


对 
activities.clear(); 


在 活动 管理 器 中 ， 我 们 通过 一 个 List 来 暂 存 活动 ， 然 后 提供 了 一 
个 addActivity() 方 法 用 于 向 List 中 添加 一 个 活动 ， 提 供 了 一 

个 removeActivity() 方 法 用 于 从 List 中 移 除 活动 ， 最 后 提供 了 一 
个 finishAl1() 方 法 用 于 将 List 中 存储 的 活动 全 部 销毁 掉 。 


接 下 来 修改 BaseActivity 中 的 代码 ， 如 下 所 示 : 


public class BaseActivity extends AppCompatActivity { 


@Ooverride 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
Log.d("BaseActivity", getClass().getSimpleName()); 
ActivityCollector.addActivity(this); 

} 


@override 

protected void onDestroy() { 
super .onDestroy(); 
ActivityCollector.removeActivity(this); 


} 


在 BaseActivity 的 oncreate( ) 方 法 中 调用 了 Activitycollector 的 
addActivity() 方 法 ， 表 明 将 当前 正在 创建 的 活动 添加 到 活动 管理 器 
里 。 然 后 在 BaseActivity 中 重 写 onDestroy() 方 法 ， 并 调用 了 
ActivityCollector 的 removeActivity() 方 法 ， 表明 将 一 个 马上 要 销毁 的 
活动 从 活动 管理 器 里 移 除 。 


从 此 以 后 ， 不 管 你 想 在 什么 地 方 退出 程序 ， 只 需要 调 





用 Activitycollector .finishA1l1() 方 法 就 可 以 了 。 例 如 在 ThirdActivity 
界面 想 通 过 点 击 按钮 直接 退出 程序 ， 只 需 将 代码 改 成 如 下 所 示 : 


public class ThirdActivity extends BaseActivity { 











@override 
protected void onCreate(Bundle savedInstanceState) { 
Super .oncCcreate(SavedInstanceState) 
Log.d("ThirdActivity", "Task id is " + getTaskId()); 
setContentView(R.1layout.third_ layout); 
Button button3 = (Button) findViewById(R.id.button_ 3); 
button3.setonClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
ActivityCollector .finishAll(); 
} 
}); 


当然 你 还 可 以 在 销毁 所 有 活动 的 代码 后 面 再 加 上 杀 掉 当前 进程 的 代码 ， 
以 保证 程序 完全 退出 ， 欠 挥 进程 的 代码 如 下 所 示 : 


android.os.Process.killProcess(android.os.Process.myPid()); 


其 中 ， a en oa 它 接 收 一 个 进程 id 参数 ， 
我 们 可 以 通 过 mypPid() 方 法 来 获得 当前 程序 的 进程 id。 需 要 注意 的 
是 ，killProcess() 方 法 只 能 用 于 杀 掉 当前 程序 的 进程 ， 我 们 不 能 使 用 
这 个 方法 去 杀 掉 其 他 程序 。 


2.6.3 ”启动 活动 的 最 佳 写 法 
启动 活动 的 方法 相信 你 已 经 非常 熟 秋 了， 首先 通过 Intent 构 建 出 当前 


的 “意图 ”， 然 后 调用 startActivity() 或 startActivityForResult() 方 法 
将 活动 启动 起 来 ， 如 果 有 数据 需要 从 一 个 活动 传递 到 另 一 个 活动 ， 也 可 
以 借助 Pntent 来 完成 。 


假设 SecondActivity 中 需要 用 到 两 个 非常 重要 的 字符 串 参数 ， 在 启动 
0 要 传递 过 来 ， 那 么 我 们 很 容易 会 写 出 如 下 代 


Intent intent = new Intent(FirstActivity.this, SecondActivity.class); 
intent.putExtra("param1", "data1"); 

intent.putExtra("param2", "data2"); 

startActivity(intent); 











这 样 写 是 完全 正确 的 ， 不 管 是 从 语法 上 还 是 规范 上 ， 只 是 在 真正 的 项 目 





开发 中 经 常会 有 对 接 的 问题 出 现 。 比 如 SecondActivity 并 不 是 由 你 :开发 
的 ， 但 现在 你 负责 的 部 分 需要 有 启动 SecondActivity 这 个 功能 能 ， 而 你 却 

不 清楚 启动 这 个 活动 需要 传递 哪些 数据 。 这 时 无 非 束 有 两 种 办 法 ， 
是 你 自己 去 阅读 SecondActivity 中 的 代码 ， 9 J" 1 页 贡 编 写 
SecondActivity 的 同事 。 你 会 不 会 觉得 很 麻烦 呢 ? 其 实 只 需要 换 一 种 写 
法 ， 束 可 以 轻松 解决 择 上 面 的 窘境 。 


修改 SecondActivity 中 的 代码 ， 如 下 所 示 : 


public class SecondActivity extends BaseActivity { 


























public Sots ic oid a nstart(Context co a xt, String datal，String data2) { 
nten 证 = ne 路 Se ontext, Se ondAc tivity.class); 

xtra(" pa 

xtra(" pe 2 data2 ) ; 

rtActi 


Ac VIVE inte nt); 








我 们 在 SecondActivity 中 添加 了 一 个 actionstart() 方 法 ， 在 这 个 方法 中 
完成 了 Intent 的 构建 ， 另 外 所 有 SecondActivity 中 需要 的 数据 都 是 通过 
actionstart() 方 法 的 参数 传递 过 来 的 ， 然 后 把 它们 存储 到 Imtent 中 ， 最 
后 调用 startActivity() 方 法 启动 SecondActivity。 


这 样 写 的 好 处 在 哪里 呢 ? 最 重要 的 一 点 就 是 一 目 了 然 ，SecondActivity 

所 需要 的 数据 在 方法 参数 中 全 部 体现 ， 了 ， 这 样 即使 不 用 阅读 

SecondActivity 中 的 代码 ， 不 去 询问 负责 编写 SecondActivity 的 同事 ， 你 
也 可 以 非常 清晰 地 知道 启动 SecondActivity 需 要 传递 哪些 数据 。 另 外 ， 

这 样 写 还 简化 了 启动 活动 的 代码 ， 现 在 只 需要 一 行 代码 就 可 以 启动 

SecondActivity， 如 下 所 示 : 





buttoni.s eton ClickListener(new OnClickListener() { 


public void on Che Se v) 区 
Seo Activi cti Orista art(FirstActivity.thi datalt, “Untaoy; 


养 成 一 个 良好 的 习惯 ， 给 你 编写 的 每 个 活动 都 添加 类 似 的 启动 方法 ， 这 
0 还 可 以 节省 不 少 你 同事 过 来 询问 
尔 的 时 间 。 


2.7 “小结 与 点 评 


真是 好 疲惫 啊 ! 没 错 ， 学 习 了 这 么 多 的 东西 不 疲惫 才 怪 呢 。 但 是 ， 你 内 
心 那 种 掌握 了 知识 的 喜悦 感 相信 也 是 无 法 掩盖 的 。 本 半 的 收获 非常 多 
啊 ， 不 管 是 理论 型 还 是 实践 型 的 东西 都 涉及 了 ， 从 活动 的 基本 用 法 ， 到 
启动 活动 和 传递 数据 的 方式 ， 再 到 活动 的 生命 周期 ， 以 及 活动 的 启动 模 
式 ， 你 几乎 已 经 学 会 了 关于 活动 所 有 重要 的 知识 点 。 另 外 在 本 章 的 最 
后 ， 还 学 习 了 几 种 可 以 应 用 在 活动 中 的 最 佳 实践 技巧 ， 坚 不 夸张 地 说 ， 
你 在 Android 活 动 方面 已 经 算是 一 个 小 高 手 了 。 


不 过 你 的 Android 旅 途 才刚 刚 开始 呢 ， 后 面 需要 学 习 的 东西 还 很 多 ， 也 
许 会 比 现在 还 累 ， 一 定 要 做 好 心理 准备 哦 。 总 体 来 说 ， 我 给 你 现在 的 状 
态 打 满 分 ， 毕 竟 你 已 经 学 会 了 那么 多 的 东西 ， 也 是 时 候 放 松 一 下 了 。 自 
己 适当 控制 一 下 休息 的 时 间 ， 然 后 我 们 继续 前 进 吧 ! 

















第 3 章 软件 也 要 拼 脸 香 一 一 UI 开 及 
的 点 点 滴 滴 


我 一 直 都 认为 程序 员 在 软件 的 审美 方面 普 过 都 比较 送 ， 人 至 少 我 个 人 就 是 
如 此 。 如 果 说 要 追究 其 根本 原因 ， 我 觉得 这 是 由 程序 员 的 工作 性 质 所 导 
致 的 。 每 当 我 们 看 到 一 个 软件 时 ， 不 会 像 普 通用 户 那 样 仅仅 是 关注 一 下 
它 的 界面 和 功能 ， 而 是 会 不 自觉 地 思考 这 些 功 能 是 如 何 实现 的 。 很 多 在 
普通 用 户 看 来 理 所 应 当 的 功能 ， 背 后 可 能 却 需要 非常 复杂 的 逻辑 来 完 
成 ， 以 至 于 当 别 人 唾 加 一句“ 这 软件 做 得 真 丑 ?的 时 候 ， 我 们 还 可 能 赞叹 
一 名 “这 功能 做 得 好 牛 啊 ”! 


不 过 缺乏 审美 观 毕竟 不 是 一 件 值 得 炫耀 的 事情 ， 在 软件 开发 过 程 中 ， 界 
面 设计 和 功能 开发 同样 重要 。 界 面 美观 的 应 用 程序 不 仅 可 以 大 大 增加 用 
户 粘 性 ， 还 能 帮 我 们 吸引 到 更 多 的 新 用 户 。 而 Android 也 给 我 们 提供 了 
和 


在 这 里 ， 我 无 法 教会 你 如 何 提升 自己 的 审美 观 ， 但 我 可 以 教会 你 怎样 使 
用 Android 提 供 的 UI 开 发 工具 来 编写 程序 界面 。 你 在 上 一 章 中 反 反 复 复 
地 使 用 那 几 个 按钮 ， 想 必 都 快要 吐 了 吧 ， 本 章 我 们 就 来 学 习 更 多 的 UI 开 
发 方面 的 知识 。 























3.1 如何 编写 程序 界面 


Android 中 有 多 种 编写 程序 界面 的 方式 可 供 选 择 。Android Studio 和 
Eclipse 中 都 提供 了 相应 的 可 视 化 编辑 器 ， 人 允许 使 用 拖 放 控件 的 方式 来 编 
写 布 局 ， 并 能 在 视图 上 直接 修改 控件 的 属性 。 不 过 我 并 不 推荐 你 使 用 这 
种 方式 来 编写 界面 ， 因 为 可 视 化 编辑 工具 并 不 利于 你 去 真正 了 解 界 面 背 
后 的 实现 原理 。 通 过 这 种 方式 制作 出 的 界面 通常 不 具有 很 好 的 屏幕 适 配 
性 ， 而 且 当 需要 编写 较为 复杂 的 界面 时 ， 可 视 化 编辑 工具 将 很 难 胜任 。 

因此 本 书 中 所 有 的 界面 都 将 通过 最 基本 的 方式 去 实现 ， 即 编写 XML 代 

码 。 等 你 完全 掌握 了 使 用 XML 来 编写 界面 的 方法 之 后 ， 不 管 是 进行 高 

0 还 是 分 析 和 修改 当前 现 有 界面 ， 对 你 来 说 都 将 是 手 
到 擒 来 。 


讲 了 这 人 么 多 理论 的 东西 ， 也 古 时 候 学习 一 下 到 确 如 何 编写 程序 界面 了 ， 
下 面 我 们 就 从 Android 中 几 种 常见 的 控件 开始 吧 。 












































3.2 ”各 用 控件 的 使 用 方法 


Android 提 供 了 大 量 的 UI 控件 ， 合 理 地 使 用 这 些 控件 就 可 以 非常 轻松 地 


编写 出 相当 不 错 的 界面 ， 下 面 我 们 束 挑 选 几 种 常用 的 控件 ， 详 细 介 绍 一 
下 它们 的 使 用 方法 。 


首先 新 建 一 个 UIWidgetTest 项 目 ， 简 单 起 见 ， 我 们 还 是 允许 Android 
Studio 上 自动 创建 活动 ， 活 动 名 和 布局 名 都 使 用 默认 值 。 


3.2.1 TextView 


TextView 可 以 说 是 Android 中 最 简单 的 一 个 控件 了 ， 你 在 前 面 其 实 已 经 
和 它 打 过 一 些 交 道 了 。 它 主要 用 于 在 界面 上 显示 一 段 文 本 信息 ， 比 如 你 
在 第 1 章 看 到 的 “Hello world! ”。 下 面 我 们 就 来 看 一 看 天 于 TextView 的 更 
多 用 法 。 





d 
io 
idth="match_parent" 
eight="ma arent" 


外 面 的 LinearLayout 先 忽略 不 看 ， 在 TextView 中 我 们 使 用 android:id 给 

当前 控件 定义 了 一 个 唯一 标识 符 ， 这 个 属性 在 上 一 章 中 已 经 讲解 过 了 。 

然后 使 用 android: layout_width 和 and roid: layout_height 指 定 控件 的 
宽度 和 遍 度 。Android 中 所 有 的 控件 都 有 具有 这 两 个 属性 ， 可 选 值 有 3 

种 : match_parent、 fill_parent 和 wrap_content。 其 中 match_parent 和 
fill_parent 的 意义 相同 ， 现 在 官方 更 加 推荐 使 

用 match_parent。 match_parent 表 示 让 当前 控件 的 大 小 和 父 布局 的 大 小 
一 样 ， 也 就 是 由 父 布 局 来 决定 当前 控件 的 大 小 。wrap_content 表 示 让 当 
前 控件 的 大 小 能 够 刚好 包含 住 里 面 的 内 容 ， 也 就 是 由 控件 内 容 决定 当前 
控件 的 大 小 。 所 以 上 面 的 代码 就 表示 让 TextView 的 客 度 和 父 布 局 一 样 





宽 ， 也 就 是 手机 屏幕 的 宽度 ， 让 TextView 的 高 度 足够 包含 住 里 面 的 内 容 
就 行 。 当 然 除 了 使 用 上 述 值 ， 你 也 可 以 对 控件 的 宽 和 高 指定 一 个 固定 的 
大 小 ， 但 是 这 样 做 有 时 会 在 不 同 手机 屏幕 的 适 配 方 面 出 现 问 题 。 


接 下 来 我 们 通过 android:text 指 定 TextView 中 显示 的 文本 内 容 ， 现 在 运 
行程 序 ， 效 果 如 网 3.1 所 示 。 
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图 3.1 TextView 运 行 效果 


虽然 指定 的 文本 内 容 正 常 显 示 了 ， 不 过 我 们 好 像 没 看 出 来 TextView 的 宽 
度 是 和 屏幕 一 样 宽 的 。 其 实 这 是 由 于 TextView 中 的 文字 默认 是 居 左 上 和 角 
对 齐 的 ， 虽 然 TextView 的 宽度 充满 了 整个 屏幕 ， 可 是 由 于 文字 内 容 不 够 
长 ， 所 以 从 效果 上 完全 看 不 出 来 。 现 在 我 们 修改 TextView 的 文字 对 齐 方 
式 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 








android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<TextView 
android:id="@+id/text_view" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:gravity="center" 
android:text="This is TextView" /> 


</LinearLayout> 





我 们 使 用 android: me 3 el 
有 top、bottom、left、right、center 等 轩 吧 定 多 个 
值 ， 这 里 我 们 指定 的 center， 效果 等 同 于 
center_vertical|center_horizontal， 表 示 文 字 在 和 王 直 和 水 平方 向 都 居 
中 对 齐 。 现 在 重新 运行 程序 ， 效 果 如 图 3.2 所 示 。 
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图 3.2 TextView 居 中 效果 
这 也 说 明了 TextView 的 宽度 确实 是 和 屏幕 宽度 一 样 的 。 








男 外 我 们 还 可 以 对 TextView 中 文字 的 大 小 和 颜色 进行 修改 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<TextView 
android:id="@+id/text_view" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:gravity="center" 
android:textSize="24sp" 
android:textColor="#00ffO0" 
android:text="This is TextView" /> 


</LinearLayout> 


通过 android:textsize 属 性 可 以 指定 文字 的 大 小 ， 通 过 
android:textcolor 属 性 可 以 指定 文字 的 颜色 ， 在 Android 中 字体 大 小 使 
用 sp 作为 单位 。 重 新 运行 程序 ， 效 果 如 图 3.3 所 示 。 
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图 3.3 ”改变 TextView 文 字 大 小 和 颜色 的 效果 


当然 TextView 中 还 有 很 多 其 他 的 属性 ， 这 里 就 不 再 一 一 介绍 了 ， 用 到 的 
时 候 去 碍 阅 文 档 就 可 以 了 。 


3.2.2 Button 


Button 是 程序 用 于 和 用 户 进 行 交 互 的 一 个 重要 控件 ， 相 信 你 对 这 个 控件 
已 经 非常 熟悉 了 ， 因 为 我 们 在 上 一 章 用 了 太 多 次 Button。 它 可 配置 的 属 
性 和 TextView 是 差不多 的 ， 我 们 可 以 在 activity_main.xml 中 这 样 加 入 


Button : 








<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<Button 
android:id="@+id/button" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Button" /> 


</LinearLayout> 


加 入 Button 之 后 的 界面 如 图 3.4 所 示 。 
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图 3.4 Button 运 行 效果 


细心 的 你 可 能 会 留意 到 ， 我 们 在 布局 文件 里 面 设置 的 文字 是 “Button”， 
但 最 终 的 显示 结果 却 是 “BUTTON”。 这 是 由 于 系统 会 对 Button 中 的 所 有 
英文 字母 自动 进行 大 写 转换 ， 如 果 这 不 是 你 想 要 的 效果 ， 可 以 使 用 如 下 
配置 来 禁用 这 一 默认 特性 : 


<Button 
android:id="@+id/button" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Button" 
android:textAllcaps="false" /> 





接 下 来 我 们 可 以 在 MainActivity 中 为 Button 的 点 击 事件 注册 一 个 监听 器 ， 
如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


@Override 


protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceSstate); 
setContentView(R.1layout.activity_main); 
Button button = (Button) findViewById(R.id.button); 
button.setonCclickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
// 在 此 处 添加 逻辑 


这 样 每 当 点 击 按钮 时 ， 惑 会 执行 监听 器 中 的 onclick() 方 法 ， 我 们 只 需 
要 在 这 个 方法 中 加 入 待 处 理 的 逻辑 就 行 了 。 如 果 你 不 喜欢 使 用 匿名 类 的 
方式 来 注册 监听 器 ， 也 可 以 使 用 实现 接口 的 方式 来 进行 注册 ， 代 码 如 下 
所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


@override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity main); 
Button button = (Button) findViewById(R.id.button); 
button.setonCclickListener(this ); 


} 


@override 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.button: 
// 在 此 处 添加 逻辑 
break; 


i 全 于 使 用 哪 一 种 就 全 赁 
尔 的 喜好 了 。 


3.2.3 EditText 


EditText 是 程序 用 于 和 用 户 进行 交互 的 另 一 个 重要 控件 ， 它 允许 用 户 在 
控件 里 输入 和 编辑 内 容 ， 并 可 以 在 程序 中 对 这 些 内 容 进行 处 理 。 
EditText 的 应 用 场景 非常 普遍 ， 在 进行 发 短信 、 发 微 博 、 聊 QQ 等 操作 
时 ， 你 不 得 不 使 用 EditText。 那 我 们 来 看 一 看 如 何在 界面 上 加 入 EditText 
吧 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 











<EditText 
android:id="@+id/edit_text" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
/> 





其 实 看 到 这 里 ， 我 估计 你 已 经 总 结 出 Android 控 件 的 使 用 规律 了 ， 用 法 
基本 上 都 很 相似 : 给 控件 定义 一 个 id， 再 指定 控件 的 宽度 和 高 度 ， 然 后 
再 适当 加 入 一 些 控 件 特有 的 属性 就 差不多 了 。 


所 以 使 用 XML 来 编写 界面 其 实 一 点 者 不 难 ， 完 全 可 以 不 用 借助 任何 可 
视 化 工具 来 实现 。 现 在 重新 运行 一 下 程序 ，EditText 就 已 经 在 界面 上 最 
示 出 来 了 ， 并 且 我 们 是 可 以 在 里 面 输入 内 容 的 ， 如 图 3.5 所 示 。 
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图 3.5 EditText 运 行 效果 


细心 的 你 平时 应 该 会 留意 到 ， 一 些 做 得 比较 人 性 化 的 软件 会 在 输入 框 里 
显示 一 些 提示 性 的 文字 ， 然 后 一 旦 用 户 输入 了 任何 内 容 ， 这 些 提示 性 的 








文字 就 会 消失 。 这 种 提示 功能 在 Android 里 是 非常 容易 实现 的 ， 我 们 甚 
至 不 需要 做 任何 的 逻辑 控制 ， 因 为 系统 已 经 帮 我 们 都 处 理 好 了 。 修 改 
activity_main.xml， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<EditText 
android:id="@+id/edit_text" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:hint="Type something here" 
/> 


</LinearLayout> 


这 里 使 用 android:hint 属 性 指定 了 一 上 段 提示 性 的 文本 ， 然 后 重新 运行 程 
序 ， 效 果 如 图 3.6 所 示 。 
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图 3.6 EditText 设 置 hint 效 果 


可 以 看 到 ，EditText 中 显示 了 一 段 提示 性 文本 ， 然 后 当 我 们 输入 任何 内 
容 时 ， 这 段 文本 就 会 目 动 消失 。 


不 过 ， 随 着 输入 的 内 容 不 断 增 多 ，EditText 会 被 不 断 地 拉 长 。 这 时 由 于 
EditText 的 高 度 指定 的 是 wrap_content ， 因 此 它 总 能 包含 住 里 面 的 内 

容 ， 但 是 当 输 入 的 内 容 过 多 时 ， 界 面 就 会 变 得 非常 难看 。 我 们 可 以 使 
用 android:maxLines 属 性 来 解决 这 个 问题 ， 修 改 activity_main.xml， 如 下 
所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 

















<EditText 
android:id="@+id/edit_text" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:hint="Type something here" 
android:maxLines="2" 
/> 


</LinearLayout> 





这 里 通过 android:maxLines 指 定 了 EditText 的 最 大 行 数 为 两 行 ， 这 样 当 输 
入 的 内 容 超过 两 行 时 ， 文 本 就 会 同上 滚动 ， 而 EditText 则 不 会 再 继续 拉 
伸 ， 如 图 3.7 所 示 。 
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图 3.7 EditText 设 置 maxLines 效 果 


我 们 还 可 以 结合 使 用 EditText 与 Button 来 完成 一 些 功 能 ， 比 如 通过 点 击 
按钮 来 获取 EditText 中 输入 的 内 容 。 修 改 MainActivity 中 的 代码 ， 如 下 所 
人 外: 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 
private EditText editText; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity_main); 
Button button = (Button) findViewById(R.id.button); 
editText = (EditText) findViewById(R.id.edit text); 
button.setOonClickListener(this); 


} 


@Override 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.button: 
String inputText = editText.getText().tostring(); 
Toast .makeText(MainActivity.this，inputText， 
Toast .LENGTH_SHORT) .show() 
break; 
default: 
break; 


首先 通过 findviewById() 方 法 得 到 EditText 的 实例 ， 然 后 在 按钮 的 点 击 
事件 里 调用 EditText 的 getText() 方 法 获取 到 输入 的 内 容 ， 再 请 

用 tost ring( ) 方 法 转换 成 字符 串 ， 最 后 还 是 老 方 法 ， 使 用 Toast 将 输入 的 
内 容 显示 出 来 。 


重新 运行 程序 ， 在 EditText 中 输入 一 段 内 容 ， 然 后 点 击 按钮 ， 效 果 如 图 
3.8 所 示 。 
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图 3.8 获取 EditText 中 输入 的 内 容 


3.2.4 ImageView 


ImageView 是 用 于 在 界面 上 展示 图 片 的 一 个 控件 ， 它 可 以 让 我 们 的 程序 
界面 变 得 更 加 丰富 多 彩 。 学 习 这 个 控件 需要 提前 准备 好 一 些 图 片 ， 图 片 
通常 都 是 放 在 以 “drawable” 开 头 的 目录 下 的 。 目 前 我 们 的 项 目 中 有 一 个 
空 的 drawable 目 录 ， 不 过 由 于 这 个 目录 没有 指定 具体 的 分 辨 率 ， 所 以 一 
般 不 使 用 它 来 放置 图 片 。 这 里 我 们 在 res 目 录 下 新 建 一 个 drawable-xhdpi 
90 0 的 两 张 图 片 img_1.png 和 img_2.png 复 制 到 该 日 


接 下 来 修改 activity_main.xml， 如 下 所 示 : 


<LinearLayou 








可 以 看 到 ， 这 里 使 用 android:src 属 性 给 ImageView 指 定 了 一 张 图 片 。 由 
于 图 片 的 宽 和 高 都 是 未 知 的 ， 所 以 将 ImageView 的 宽 和 高 都 设 定 

为 wrap_content， 这 样 束 保证 了 了 不管 图 片 的 尺寸 是 多 少 ， 图 片 都 可 以 完 
整地 展示 出 来 。 重 新 运行 程序 ， 效 果 如 图 3.9 所 示 。 
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图 3.9 ImageView 运 行 效 果 


我 们 还 可 以 在 程序 中 通过 代码 动态 地 更 改 InageView 中 的 图 片 ， 然 后 修 
改 MainActivity 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 
private EditText editText; 
private ImageView imageView; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity_main); 
Button button = (Button) findViewById(R.id.button); 
editText = (EditText) findViewById(R.id.edit text); 
imageView = (ImageView) findViewById(R.id.image view); 
button.setOonclickListener(this); 


= 


@Override 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.button: 
imageView,.setImageResource(R.drawable.img 2); 
break; 
default: 
break; 


在 按钮 的 点 击 事件 里 ， 通过 调用 ImageView 的 setImageResource() 方 法 
将 显示 的 图 片 改 成 img_2， 现 在 重新 运行 程序 ， 然 后 点 击 一 下 按钮 ， 就 
可 以 看 到 ImageView 中 显示 的 图 片 改 变 了 ， 如 图 3.10 所 示 。 
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图 3.10 动态 更 改 ImageView 中 的 图 片 
3.2.5 ProgressBar 


ProgressBar 用 于 在 界面 上 显示 一 个 进度 条 ， 表 示 我 们 的 程序 正在 加 载 一 
些 数据 。 它 的 用 法 也 非常 人 简单， 修改 activity_main.xml 中 的 代码 ， 如 下 
所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 


android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<ProgressBar 
android:id="@+id/progress_bar" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
Ps 


</LinearLayout> 


重新 运行 程序 ， 会 看 到 屏幕 中 有 一 个 圆 形 进度 条 正在 旋转 ， 如 图 3.11 所 
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图 3.11 ProgressBar 运 行 效果 


这 时 你 可 能 会 问 ， 旋 转 的 进度 条 表明 我 们 的 程序 正在 加 载 数 据 ， 那 数据 
总 会 有 加 载 完 的 时 候 吧 ? 如 何 才 能 让 进度 条 在 数据 加 载 完 成 时 消失 呢 ? 
这 里 我 们 惑 需 要 用 到 一 个 新 的 知识 点 : Android 控 件 的 可 见 属 性 。 所 有 


的 Android 控 件 都 具有 这 个 属性 ， 可 以 通过 android:visibility 进 行 指 
定 ， 可 选 值 有 3 种 : visible、 invisible 和 gone。 visible 表 示 探 件 是 可 
见 的 ， 这 个 值 是 默认 值 ， 不 指定 android:visibility 时 ， 控 件 都 是 可 见 
的 。invisible 表 示 控 件 不 可 见 ， 但 是 它 仍 然 占据 着 原来 的 位 置 和 大 
小 ， 可 以 理解 成 控件 变 成 透明 状态 了。gone 则 表示 控件 不 仅 不 可 见 ， 而 
且 不 再 占用 任何 屏幕 空间 。 我 们 还 可 以 通过 代码 来 设置 控件 的 可 见 性 
使 用 的 是 setvisibility() 方 法 ， 可 以 传 


入 View.VISIBLE、View,.INVISIBLE 和 View， GONE 这 3 种 值 o 


接 下 来 我 们 就 来 尝试 实现 ， 点 击 一 下 按钮 让 进度 条 消失 ， 再 点 击 一 下 按 
钮 让 进度 条 出 现 的 这 种 效果 。 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 











private EditText editText; 
private ImageView imageView; 
private ProgressBar progressBar ; 


@override 
protected void onCreate(Bundle SavedInstanceState) { 
Super .oncCcreate(SavedInstanceState) 
setContentView(R.1layout.activity main); 
Button button = (Button) findViewById(R.id.button); 
editText = (EditText) findViewById(R.id.edit_text) 
imageView = (ImageView) findViewById(R.id.image view); 
progressBar = (ProgressBar) findViewById(R.id.progress_bar); 
button.setonCclickListener(this ) ; 
} 
@override 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.button: 
if (progressBar.getVisibility() == View.GONE) { 
progressBar .setVisibility(View.VISIBLE); 


} else { 
progressBar .setVisibility(View.GONE); 


在 按钮 的 点 击 事件 中 ， 我 们 通过 getvisibility() 方 法 来 判断 ProgressBar 
是 否 可 见 ， 如 果 可 见 就 将 ProgressBar 隐 藏 挥 ， 如 果 不 可 见 就 将 
ProgressBar 显 示 出 来 。 重 新 运行 程序 ， 然 后 不 断 地 点 击 按 钮 ， 你 就 会 看 
到 进度 条 会 在 显示 与 隐藏 之 间 来 回 切换 。 


另外 ， 我 们 还 可 以 给 ProgressBar 指 定 不 同 的 样式 ， 刚 刚 是 圆 形 进度 条 ， 
通过 style 属 性 可 以 将 它 指 定 成 水 平 进度 条 ， 修 改 activity_main.xml 中 的 
代码 ， 如 下 所 示 : 


<LinearLayout xmlns android= "http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 














android:layout_height="match_parent"> 


<ProgressBar 
android:id="@+id/progress_bar" 
android:layout_width="match_parent" 
android:layout_height="wrap_content 
style="?android:attr/progressBarStyleHorizontal" 
android:max="100" 
/> 


</LinearLayout> 





指定 成 水 平 进 度 条 后 ， 我 们 还 可 以 通过 android:max 属 性 给 进度 条 设 
一 个 最 大 值 ， 然 后 在 代码 中 动态 地 更 改进 度 条 的 进度 。 修 改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


@override 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.button: 
int progress = progressBar.getProgress(); 
progress = progress + 
progressBar.setProgress(progress); 











每 点 击 一 次 按钮 ， 我 们 就 获取 进度 条 的 当前 进度 ， 然 后 在 现 有 的 进度 上 
加 10 作 为 更新 后 的 进度 。 重新 运行 程序 ， 点 击 数 次 按钮 后 ， 效 果 如 图 
3.12 所 示 。 
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This is TextView 


BUTTON 


mething here 








图 3.12 ”ProgressBar 水 平 样式 效果 
ProgressBar 还 有 几 种 其 他 的 样式 ， 你 可 以 自己 去 尝试 一 下 。 
3.2.6 AlertDialog 


AlertDialog 可 以 在 当前 的 界面 弹出 一 个 对 话 框 ， 这 个 对 话 框 是 置顶 于 所 
有 界面 元 素 之 上 的 ， 能 够 屏蔽 掉 其 他 控件 的 交互 能 力 ， 因 此 AlertDialog 
一 般 都 是 用 于 提示 一 些 非 常 重要 的 内 容 或 者 警告 信息 。 比 如 为 了 防止 用 
户 误 删 重要 内 容 ， 在 删除 前 弹出 一 个 确认 对 话 框 。 下 面 我 们 来 学 习 一 下 
它 的 用 法 ， 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 




















@Override 
public void onClick(View v) { 
Switch (v.getId()) { 
ase R.id.button: 
AlertDialog.Builder dialog = new AlertDialog.Builder (MainActivity. 


this); 
dialog.setTitle("This is Dialog"); 
dialog.setMessage("Something important."); 
dialog. setCancelable(false); 
dialog.setPositiveButton("OK", new DialogInterface. 
OnclickListener() { 
@Ooverride 
public void onClick(DialogInterface dialog, int which) { 


}); 

dialog.setNegativeButton("Cancel", new DialogInterface. 
OnclickListener() { 
@override 
public void onClick(DialogInterface dialog, int which) { 


}); 
dialog.show(); 
break; 


default: 
break; 


首先 通过 AlertDialog.Builder 创 建 一 个 AlertDialog 的 实例 ， 然 后 可 以 为 这 
个 对 话 框 设置 标题 、 内 容 、 可 人 否 用 Back 键 关闭 对 话 框 等 属性 ， 接 下 来 调 
用 setPositiveButton() 方 法 为 对 话 框 设置 确定 按钮 的 点 击 事 件 ， 

用 setNegativeButton() 方 法 设置 取消 按钮 的 点 击 事件 ， 最 后 调用 show() 
方法 将 对 话 框 显示 出 来 。 重 新 运行 程序 ， 点 击 按 钮 后 ， 效 果 如 图 3.13 所 
示 。 











This is Dialog 


Something Important. 


CANCEL OK 





图 3.13 AlertDialog 运 行 效果 


3.2.7 ProgressDialog 


ProgressDialog 和 AlertDialog 有 点 类 似 ， 都 可 以 在 界面 上 弹出 一 个 对 话 
框 ， 都 能 够 屏蔽 挥 其 他 控件 的 交互 能 力 。 不 同 的 是 ，ProgressDialog 会 在 
对 话 框 中 显示 一 个 进度 条 ， 一 般 用 于 表示 当前 操作 比较 耗 时 ， 让 用 户 耐 
心地 等 待 。 它 的 用 法 和 AlertDialog 也 比较 相似 ， 人 和 修改 MainActivity 中 的 代 
码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 





@Override 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.button: 
ProgressDialog progressDialog = new ProgressDialog 
(MainActivity.this); 
progressDialog.setTitle("This is pooresso oro, js 
progressDialog.setMessage("Loading..."); 
progressDialog.setCancelable(true); 
progressDialog. show(); 


break; 
default: 
break; 
} 
} 


} 


可 以 看 到 ， 这 里 也 是 先 构建 出 一 个 ProgressDialog 对 象 ， 然 后 同样 可 以 
设置 标题 、 内 容 、 可 否 取 消 等 属性 ， 最 后 也 是 通过 调用 show( ) 方 法 将 
ProgressDialog 显 示 出 来 。 重 新 运行 程序 ， 扣 击 按钮 后 ， 效 来 如 图 3.14 所 
示 。 


This is ProgressDialog 





图 3.14 ” ProgressDialog 运 行 效 果 


注意 ， 如 果 在 setcancelable() 中 传 入 了 false， 表 示 ProgressDialog 是 不 
能 通过 Back 键 取消 掉 的 ， 这 时 你 就 一 定 要 在 代码 中 做 好 控制 ， 当 数据 加 
载 完成 后 必须 要 调用 ProgressDialog 的 dismiss() 方 法 来 关闭 对 话 框 ， 人 否 





则 ProgressDialog 将 会 一 直 存 在 。 


好 了 ， 关 于 Android 和 常用 控件 的 使 用 ， 我 要 讲 的 就 只 有 这 么 多 。 一 市 内 

容 束 想 禾 六 Android 控 件 所 有 的 相关 知识 不 太 现 实 ， 同 样 一 口气 束 想 学 

会 所 有 Android 控 件 的 使 用 方法 也 不 太 现 实 。 本 节 所 讲 的 内 容 对 于 你 来 

说 只 是 起 到 了 一 个 引导 的 作用 ， 你 还 需要 在 以 后 的 学 习 和 工作 中 不 断 地 
摸索 ， 通 过 得 阅 文 档 以 及 网 上 搜索 的 方式 学 习 更 多 控件 的 更 多 用 法 。 当 
然 ， 当 本 书后 面 涉 及 一 些 我 们 前 面 没 学 过 的 控件 和 相关 用 法 时 ， 我 仍然 
会 在 相应 的 章节 做 详细 的 讲解 。 








3.3 ”详解 4 种 基本 布局 


一 个 丰富 的 界面 总 是 要 由 很 多 个 控件 组 成 的 ， 那 我 们 如 何 才能 让 各 个 控 
件 都 有 条 不 率 地 摆 放 在 界面 上 ， 而 不 是 乱糟糟 的 呢 ? 这 束 需 要 借助 布局 
来 实现 了 。 布 局 是 一 种 可 用 于 放置 很 多 控件 的 容 费 ， 它 可 以 控 照 一 定 的 
规律 调整 内 部 控件 的 位 置 ， 从 而 编写 出 精美 的 界面 。 当 然 ， 布 局 的 内 部 
除了 放置 控件 外 ， 也 可 以 放置 布局 ， 通 过 多 层 布局 的 藤 套 ， 我 们 就 能 够 
完成 一 些 比较 复杂 的 界面 实现 ， 图 3.15 很 好 地 展示 了 它们 之 间 的 关系 。 














图 3.15 布局 和 控件 的 关系 

下 面 我 们 来 详细 讲解 下 Android 中 4 种 最 基本 的 布局 。 先 做 好 准备 工作 ， 
新 建 一 个 UILayoutTest 项 目 ， 并 让 Android ”Studio 自 动 帮 我 们 创建 好 活 
动 ， 活 动 名 和 布局 名 都 使 用 默认 值 。 

3.3.1 线性 布局 


LinearLayout 又 称 作 线 性 布局 ， 是 一 种 非常 常用 的 布局 。 正 如 它 的 名 字 














所 摘 述 的 一 样 ， 这 个 布局 会 将 它 所 包含 的 控件 在 线性 方向 上 依次 排列 。 
相信 你 之 前 也 已 经 注意 到 了 ， 我 们 在 上 一 节 中 学 习 控 件 用 法 时 ， 所 有 的 
控件 就 都 是 放 在 LinearLayout 布 局 里 的 ， 因 此 上 一 节 中 的 控件 也 确实 是 
在 垂直 方向 上 线性 排列 的 。 


既然 是 线性 排列 ， 表 定 就 不 仅 只 有 一 个 方 同 ， 那 为 什么 上 一 节 中 的 控件 
都 是 在 垂直 方 回 排列 的 呢 ? 这 是 由 于 我 们 通过 android:orientation 属 性 
指定 了 排列 方 癌 是 vertical， 如 果 指 定 的 是 horizontal， 控 件 就 会 在 水 平方 
同上 排列 了 。 下 面 我 们 通过 实战 来 体会 一 下 ， 修 改 activity_main.xml 中 
的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertica. 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 





<Button 
android:id="@+id/buttoni1" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="Button 1" /> 


<Button 
android:id="@+id/button2" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="Button 2" /> 


<Button 
android:id="@+id/button3" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="Button 3" /> 








</LinearLayout> 


我 们 在 LinearLayout 中 添加 了 3 个 Button， 每 个 Button 的 长 和 宽 都 
是 wrap_content， 并 指定 了 排列 方向 是 vertical。 现 在 运行 一 下 程序 ， 效 
果 如 图 3.16 所 示 。 








UILayoutTest 


BUTTON 1 


BUTTON 2 


BUTTON 3 








图 3.16 ”LinearLayout 垂 直 排 列 
然后 我 们 修改 一 下 LinearLayout 的 排列 方向 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


</LinearLayout> 


将 android:orientation 属 性 的 值 改 成 了 horizontal， 这 就 意味 着 要 让 
LinearLayout 中 的 控件 在 水 平方 同上 依次 排列 。 当 然 如 果 不 指 定 
android:orientation 属 性 的 值 ， 默 认 的 排列 方 同 束 是 horizontal。 重 新 运 
行 一 下 程序 ， 效 果 如 图 3.17 所 示 。 


UILayoutTest 


BUTTON1 BUTTON2 BUTTON3 








图 3.17 LinearLayout 水 平 排列 


这 里 需要 注意 ， 如 果 LinearLayout 的 排列 方 辐 是 horizontal， 内 部 的 控件 

束 绝 对 不 能 将 寺 度 指定 为 match_parent， 因 为 这 样 的 话 ， 单 独 一 个 控件 
就 会 将 整个 水 平方 癌 占 满 ， 其 他 的 控件 就 没有 可 放置 的 位 置 了 。 同 样 的 
道理 ， 如 果 LinearLayout 的 排列 方向 是 vertical， 内 部 的 控件 就 不 能 将 高 

度 指 定 为 natch_parent。 


首先 来 看 android:1layout_gravity 属 性 ， 它 和 我 们 上 一 节 中 学 到 的 
android:gravity 属 性 看 起 来 有 些 相 似 ， 这 两 个 属性 有 什么 区 别 呢 ? 其 实 
从 名 字 就 可 以 看 出 ，android:gravity 用 于 指定 文字 在 控件 中 的 对 齐 方 
式 ， 而 android:layout_gravity 用 于 指定 控件 在 布局 中 的 对 齐 方 

Ts android:layout_gravity 的 可 选 值 和 android:gravity 差 不 多 ， 但 是 
需要 注意 ， 当 LinearLayout 的 排列 方向 是 horizontal 时 ， 只 有 垂直 方向 上 
的 对 齐 方式 才 会 生效 ， 因 为 此 时 水 平方 同上 的 长 度 是 不 固定 的 ， 每 添加 











一 个 控件 ， 水 平方 和 同上 的 长 度 都 会 改变 ， 因 而 无 法 指定 该 方向 上 的 对 齐 


方式 。 同 样 的 道理 ， 


当 LinearLayout 的 排列 方 回 是 vertical 时 ， 只 有 水 平 


问 上 的 对 齐 方式 才 会 生效 。 修 改 activity_main.xml 中 的 代码 ， 如 下 所 
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<LinearLayout xmlns:android= 


"http://schemas.android.com/apk/res/android" 


android:orientation="horizontal" 


android:1layout_width="ma 


tch_parent" 


android:layout_height="match_parent"> 


<Button 
android:id="@+id/but 


toni" 


android:layout_width="wrap_content" 


android:layout_heigh 
android:layout_gravi 
android:text="Button 


<Button 
android:id="@+id/but 


t="wrap_content" 
ty="top" 
pa 


ton2" 


android:layout_width="wrap_content" 


android:layout_heigh 
android:layout_gravi 
android:text="Button 


<Button 
android:id="@+id/but 


t="wrap_content" 
ty="center_vertical" 
i 


ton3" 


android:layout_width="wrap_content" 


android:layout_heigh 
android:layout_gravi 
android:text="Button 


</LinearLayout> 





t="wrap_content" 
ty="bottom" 
Ft 


由 于 目前 LinearLayout 的 排列 方向 是 horizontal， 因 此 我 们 只 能 指定 垂直 


方 回 上 的 排列 方向 ， 


将 第 一 个 Button 的 对 齐 方式 指定 为 ttp， 第 二 个 


Button 的 对 齐 方式 指定 为 center_vertical， 第 三 个 Button 的 对 齐 方 式 指定 


为 bottom。 重 新 运行 


程序 ， 效 果 如 图 3.18 所 示 。 






UILayoutTest 








BUTTON 1 


BUTTON 2 


BUTTON 3 








图 3.18 ”指定 layout_gravity 的 效果 
接 下 来 我 们 学 习 下 LinearLayout 中 的 另 一 个 重要 属性 





android:1layout_ weight。 


钮 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<EditText 


android:id="@+id/input_message" 
android:layout_width="Qdp" 
android:layout_height=" rap content" 
android:layout_ weight="1 
android:hint="Type something" 


/> 


<Button 


android:id="@+id/send" 
android:layout_width="Qdp" 
android:layout_height=" sap content" 


android:layout_ weight="1 


android:text="Send 


这 个 属性 允许 我 们 使 用 比例 的 方式 来 指定 
控件 的 大 小 ， ss 比 


如 我 们 正在 编写 一 个 消 轧 发 送 界 面 ， 需 要 一 个 文本 编辑 框 和 一 个 用 送 按 


</LinearLayout> 


你 会 发 现 ， 这 里 竟然 将 EditText 和 Button 的 宽度 都 指定 成 了 0dp， 这 样 文 
本 编辑 框 和 按钮 还 能 显示 出 来 吗 ? 不 用 担心 ， 由 于 我 们 使 用 了 
android:1layout_weight 属 性 ， 此 时 控件 的 宽度 就 不 应 该 再 

由 android:1layout_width 来 决定 ， 这 里 指定 成 0dp 是 一 种 比较 规范 的 写 
法 。 男 外 ，dp 是 Android 中 用 于 指定 控件 大 小 、 间 距 等 属性 的 单位 ， 后 
面 我 们 还 会 经 常用 到 它 。 


然后 在 EditText 和 Button 里 都 将 android:1layout_weight 属 性 的 值 指 定 为 
1， 这 表示 EditText 和 Button 将 在 水 平方 向 平分 宽度 。 


为 什么 将 android:layout_weight 属 性 的 值 同 时 指定 为 1 就 会 平分 屏幕 宽 
度 呢 ? 其 实 原理 也 很 简单 ， 系 统 会 先 把 LinearLayout 下 所 有 控件 指定 的 
layout_weight 值 相 加 ， 得 到 一 个 总 值 ， 然 后 每 个 控件 所 占 大 小 的 比例 
就 是 用 该 控件 的 layout_weight 值 除 以 刚才 算出 的 总 值 。 因 此 如 果 想 让 
EditText 占 据 屏 幕 宽度 的 305，Button 占 据 屏 幕 宽度 的 205， 只 需要 将 
EditText 的 layout_weight 改 成 ?3，Button 的 layout_weight 改 成 2 就 可 以 
本 


重新 运行 程序 ， 你 会 看 到 如 图 3.19 所 示 的 效果 。 
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UILayoutTest 











图 3.19 ”指定 layout_weight 的 效果 


我 们 还 可 以 通过 指定 部 分 控件 的 layout_weight 值 来 实现 更 好 的 效果 。 
修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 





<EditText 
android:id="@+id/input_message" 
android:layout_width="Qdp" 
android:layout_height="wrap_content" 
android:layout_ weight="1" 
android:hint="Type something" 
/> 


<Button 
android:id="@+id/send" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="Send" 
jy 


</LinearLayout> 


这 里 我 们 仅 指 定 了 EditText 的 android:layout_weight 属 性 ， 并 将 Button 
的 宽度 改 回 wrap_content。 这 表示 Button 的 宽度 仍然 按照 wrap_content 
来 计算 ， 而 EditText 则 会 占 满 屏幕 所 有 的 剩余 空间 。 使 用 这 种 方式 编写 
的 界面 ， 不 仅 在 各 种 屏幕 的 适 配 方面 会 非常 好 ， 而 且 看 起 来 也 更 加 和合 
服 。 重 新 运行 程序 ， 效 果 如 图 3.20 所 示 。 


UlLayoutTest 








图 3.20 ”使 用 1ayout_weight 实 现 宽 度 自 适 配 效 果 
3.3.2 ”相对 布局 


RelativeLayout 又 称 作 相对 布局 ， 也 是 一 种 非常 音 用 的 布局 。 和 
LinearLayout 的 排列 规则 不 同 ，RelativeLayout 显 得 更 加 随意 一 些 ， 它 可 
以 通过 相对 定位 的 方式 让 控件 出 现在 布局 的 任何 位 置 。 也 正 因为 如 此 ， 
RelativeLayout 中 的 属性 非常 多 ， 不 过 这 些 属性 都 是 有 规律 可 循 的 ， 其 实 
并 不 难 理解 和 记忆 。 我 们 还 是 通过 实践 来 体会 一 下 ， 修 改 














activity_main.xml 中 的 代码 ， 如 下 所 示 : 








<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 

android:layout_width="match_parent" 

android:layout_height="match_parent"> 

<Button 
android:id="@+id/buttoni1" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_alignParentLeft="true" 
android:layout_alignParentTop="true" 
android:text="Button 1" /> 

<Button 
android:id="@+id/button2" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_alignParentRight="true" 
android:layout_alignParentTop="true" 
android:text="Button 2" /> 

<Button 
android:id="@+id/button3" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_centerInParent="true" 
android:text="Button 3" /> 

<Button 
android:id="@+id/button4" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_alignParentBottom="true" 
android:layout_alignParentLeft="true" 
android:text="Button 4" /> 

<Button 
android:id="@+id/button5s" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_alignParentBottom="true" 
android:layout_alignParentRight="true" 
android:text="Button 5" /> 

</RelativeLayout> 





我 想 以 上 代码 已 经 不 需要 我 再 做 过 多 解释 了 ， 因 为 实在 是 太 好 理解 了 。 
我 们 让 Button 1 和 父 布局 的 左上 角 对 齐 ，Button 2 和 父 布 局 的 右上 角 对 
齐 ，Button 3 居中 显示 ，Button 4 和 父 布局 的 左下 角 对 齐 ，Button 5 和 父 
布局 的 在下 角 对 齐 。 虽 


android:layout_alignParentLeft、android:layout_alignParentTop、 


这 几 个 属性 我 们 之 前 都 没 接 触 过 ， 可 是 它们 的 名 字 已 经 完全 说 明了 它们 


然 


4 








的 作用 。 重 新 运行 程序 ， 效 果 如 图 3.21 所 示 。 
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BUTTON 3 








图 3.21 相对 于 父 布局 定位 的 效果 


上 面 例子 中 的 每 个 控件 都 是 相对 于 父 布局 进行 定位 的 ， 那 控件 可 不 可 以 
相对 于 控件 进行 定位 呢 ? 当然 是 可 以 的 ， 修 改 activity_main.xml 中 的 代 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 





<Button 
android:id="@+id/button3" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_centerInParent="true" 
android:text="Button 3" /> 


<Button 
android:id="@+id/buttoni" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_above="@id/button3" 
android:layout_toLeft0of="@id/button3" 
android:text="Button 1" /> 


<Button 
android:id="@+id/button2" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_above="@id/button3" 





android: layout— toRightof="@id/button3" 
android:text="Button 2" /> 


<Button 
android:id="@+id/button4" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_below="@id/button3" 
android:layout_toLeftof="@id/button3" 
android:text="Button 4" /> 


<Button 
android:id="@+id/button5s" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_below="@id/button3" 
android:layout_toRightof="@id/button3" 
android:text="Button 5" /> 





</RelativeLayout> 


这 次 的 代码 稍微 复杂 一 点 ， 不 过 仍然 是 有 规律 可 循 

的 。 i 性 可 以 让 一 个 控件 位 于 男 一 个 控件 的 上 

方 ， 需 要 为 这 个 属性 指定 相对 控件 id 的 引用 ， 这 里 我 们 填 入 了 

@id/button3， 表 示 让 该 控件 位 于 Button 3 的 上 方 。 其 他 的 属性 也 都 是 相 

似 的 ，android: layout_below 表 示 让 一 个 控件 位 于 另 一 个 控件 的 下 

方 ， android:layout_toLeftof 表 示 让 一 个 控件 位 于 另 一 个 控件 的 左 

侧 ，android:1layout_toRightof 表 示 让 一 个 控件 位 于 男 一 个 控件 的 右 

侧 。 注 意 ， 当 一 个 控件 去 引用 另 一 个 控件 的 id 时 ， 该 控件 一 定 要 定义 在 

0 不 然 会 出 现 找 不 到 id 的 情况 。 重 新 运行 程序 ， 效 果 如 
3.22 所 不 。 
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图 3.22 相对 于 控件 定位 的 效果 


RelativeLayout 中 还 有 另外 一 组 相对 于 控件 进行 定位 的 属 

性 ，android:1layout_alignLeft 表 示 让 一 个 控件 的 左边 缘 和 男 一 个 控件 
的 左边 缘 对 齐 ，android:layout_alignRight 表 示 让 一 个 控件 的 右边 缘 和 
另 一 个 控件 的 右边 缘 对 齐 。 此 外 ， 还 有 android:layout_alignTop 和 
android:layout_alignBottom， 道 理 都 是 一 样 的 ， 我 就 不 再 多 说 ， 这 几 
个 属性 就 留 给 你 自己 去 尝试 吧 。 


好 了 ， 正 如 我 前 面 所 说 ，RelativeLayout 中 的 属性 虽然 多 ， 但 都 是 有 规律 
可 循 的 ， 所 以 学 起 来 一 点 都 不 觉得 吃力 吧 ? 


3.3.3” 帧 布局 
FrameLayout 义 称 作 帧 布局 ， 它 相 比 于 前 面 两 种 布局 就 简单 太 多 了 ， 








此 它 的 应 用 场景 也 少 了 很 多 。 这 种 布局 没有 方便 的 定位 方式 ， 所 有 的 控 
件 都 会 默认 摆 放 在 布局 的 左上 角 。 让 我 们 通过 例子 来 看 一 看 吧 ， 修 改 
activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<TextView 
android:id="@+id/text_view" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="This is TextView" 


<ImageView 
android:id="@+id/image_view" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:src="@mipmap/ic_launcher" 
/> 





</FrameLayout> 


FrameLayout 中 只 是 放置 了 一 个 TextView 和 一 个 ImageView。 需 要 注意 的 
是 ， 当 前 项 目 我 们 没有 准备 任何 图 乒 ， 所 以 这 里 ImageView 直 接 使 用 了 
@mipmap 来 访问 ic_launcher 这 张 图 ， 虽 说 这 种 用 法 的 场景 可 能 非常 少 ， 但 
我 还 是 要 告诉 你 ， 这 是 完全 可 行 的。 重新 运行 程序 ， 效 果 如 网 3.23 所 


钞 。 
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图 3.23 FrameLayout 运 行 效 果 


可 以 看 到 ， 文 字 和 图 片 都 是 位 于 布局 的 左上 角 。 由 于 ImageView 是 在 
TextView 之 后 添加 的 ， 因 此 图 片 压 在 了 文字 的 上 面 。 


当然 除了 这 种 默认 效果 之 外 ， 我 们 还 可 以 使 用 layout_gravity 属 性 来 指 
定 控件 在 布局 中 的 对 齐 方 式 ， 这 和 LinearLayout 中 的 用 法 是 相似 的 。 修 
改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 

















<TextView 
android:id="@+id/text_view" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="left" 
android:text="This is TextView" 
pu 


<ImageView 
android:id="@+id/button" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="right" 





我 们 指定 TextView 在 FrameLayout 中 居 左 对 齐 ， 指 定 ImageView 在 
FrameLayout 中 居 右 对 齐 ， 然 后 重新 运行 程序 ， 效 果 如 图 3.24 所 示 。 
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图 3.24 指定 layout_gravity 的 效果 


总 体 来 讲 ，FrameLayout 由 于 定位 方式 的 欠缺 ， 导 致 它 的 应 用 场景 也 比 
较 少 ， 不 过 在 下 一 童 中 介绍 碎片 的 时 候 我 们 还 是 可 以 用 到 它 的 。 


3.3.4 ”百分比 布局 


前 面 介绍 的 3 种 布局 都 是 从 Android ”1.0 版 本 中 就 开始 支持 了 ， 一 直 沿 用 
到 现在 ， 可 以 说 是 满足 了 绝 大 多 数 场 景 的 界面 设计 需求 。 不 过 细心 的 你 








会 发 现 ， 只 有 LinearLayout 文 持 使 用 1ayout_weight 属 性 来 实现 按 比例 指 

定 控件 大 小 的 功能 ， 其 他 两 种 布局 都 不 文 持 。 比 如 说 ， 如 有 果 想 用 

An 按钮 平分 布局 宽度 的 效果 ， 则 是 比较 困难 
何 


为 此 ，Android 引 入 了 一 种 全 新 的 布局 方式 来 解决 此 问题 一 一 百分比 布 
局 。 在 这 种 布局 中 ， 我 们 可 以 不 再 使 用 wrap_content、match_parent 等 
方式 来 指定 控件 的 大 小 ， 而 是 允许 直接 指定 控件 在 布局 中 所 占 的 百 分 

比 ， 这 样 的 话 就 可 以 轻松 实现 平分 布局 甚至 是 任意 比例 分 割 布 局 的 效果 
本 


由 于 LinearLayout 本 里 已 经 文 持 按 比 例 指定 控件 的 大 小 了 ， 因 此 百分比 
布局 只 为 FrameLayout 和 RelativeLayout 进 行 了 功能 扩展 ， 提 供 了 
PercentFrameLayout 和 PercentRelativeLayout 这 两 个 全 新 的 布局 ， 下 面 我 
们 就 来 具体 学 习 一 下 。 


不 同 于 前 3 种 布局 ， 百 分 比 布局 属于 新 增 布局 ， 那 么 怎么 才能 做 到 让 新 

增 布局 在 所 有 Android 版 本 上 都 能 使 用 呢 ? 为 此 ，Android 团 队 将 百分比 

布局 定义 在 了 support 库 当中 ， 我 们 只 需要 在 项 目的 build.gradle 中 添加 百 

ee 就 能 保证 百分比 布局 在 Android 所 有 系统 版 本 上 的 
容 性 了 。 


打开 app/build.gradle 文 件 ， 在 dependencies 闭 包 中 添加 如 下 内 容 : 














需要 注意 的 是 ， 每 当 修 改 了 任何 gradle 文 件 时 ，Android Studio 都 会 弹出 
一 个 如 图 3.25 所 示 的 提示 。 





Gradle files have changed since last project sync. A project sync may be necessary for the IDE to work properly， Sync Now | 
图 3.25 ”gradle 文 件 修改 后 的 提示 


这 个 提示 告诉 我 们 ，gradle 文 件 自 上 次 同步 之 后 又 发 生 了 变化 ， 需 要 再 
次 同步 才能 使 项 目 正常 工作 。 这 里 只 需要 点 击 Sync Now 束 可 以 了 ， 然 后 





gradle 会 开始 进行 同步 ， 把 我 们 新 添加 的 百分比 布局 库 引 入 到 项 目 当 


O 


接 下 来 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<android.support . percent. PercentFrameLayout 
xmlns: android= "http://schemas.android. com/apk/res/android" 
xmlns:app="http://schemas.android. com/apk/res- auto" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<Button 
android: id="@tid/buttoni" 
android:text="Button 1" 
android:layout_gravity= "left|top" 
app:layout_widthPercent="50% 
app:layout_heightPercent="50%" 
/> 


<Button 
android:id="@+id/button2" 
android:text="Button 2" 
android:layout_gravity=" bop 
app:layout_widthPercent="50% 
Sh: layout_heightPercent=" '50%" 


<Button 
android:id="@+id/button3" 
android:text="Button 3" 
android:layout_gravity= "left |bottom" 
app:layout_widthPercent="50% 
app: layout_heightPercent="50%" 


<Button 
android:id="@+id/button4" 
android:text="Button 4" 
android:layout_gravity=" os leo 
app:layout_widthPercent="50% 
oeP layout_heightPercent=" '50%" 


<Vandroid.support.percent .PercentFrameLayout> 


最 外 层 我 们 使 用 了 PercentFrameLayout， 由 于 百分比 布局 并 不 是 内 置 在 
系统 SDK 当 中 的 ， 所 以 需要 把 完整 的 包 路 径 写 出 来 。 然 后 还 必须 定义 一 
个 app 的 命名 空间 ， 这 样 才能 使 用 百分比 布局 的 自 定 义 属性 


在 PercentFrameLayout 中 我 们 定义 了 4 个 按钮 ， 使 

用 app:1layout_widthPercent 属 性 将 各 按钮 的 宽度 指定 为 布局 的 50%， 使 
用 app:layout_heightPercent 属 性 将 各 按钮 的 高 上 度 指定 为 布局 的 50%。 
这 里 之 所 以 能 使 用 app 前 级 的 属性 就 是 因为 刚才 定义 了 app 的 命名 空间 ， 
当然 我 们 一 直 能 使 用 android 前 绥 的 属性 也 是 同样 的 道理 。 


不 过 PercentFrameLayout 还 是 会 继承 FrameLayout 的 特性 ， 即 所 有 的 控件 
默认 痢 是 摊 放 在 布局 的 左上 角 。 那 么 为 了 让 这 4 个 控 钮 不 会 重合 ， 这 里 
还 是 借助 了 layout_gravity 来 分 别 将 这 4 个 按钮 放置 在 布局 的 左 已 而 
上 、 左 下 、 右 下 4 个 位 置 。 











现在 我 们 已 经 可 以 重新 运行 程序 了 ， 不 过 如 采 你 使 用 的 是 老 版 本 的 
Android ”Studio， 可 能 会 在 activity_main.xml 中 看 到 一 些 如 图 3.26 所 示 的 
音 误 提 示 。 





| layout height attribute should be defined more... (Ctr|+F1) | 








layout_width' attribute should be defined more... (Ctr|+F1) | 





图 3.26 ”activity_main.xml 中 错误 提示 


这 是 因为 老 版 本 的 Android Studio 中 内 置 了 布局 的 检查 机 制 ， 认 为 每 一 个 
控件 都 应 该 通过 android:1layout_width 和 android:1layout_height 属 性 指 
定 宽 高 才 是 合法 的 。 而 其 实 我 们 是 通过 app:1layout_widthPercent 和 
app:layout_heightPercent 属 性 来 指定 宽 高 的 ， 所 以 Android Studio 没 检 
测 到 。 不 过 这 个 错误 提示 并 不 影响 程序 运行 ， 我 们 直接 忽视 就 可 以 了 。 
当然 最 新 的 Android Studio 2.2 版 本 中 己 经 修复 了 这 个 问题 ， 因 此 你 可 能 
并 不 会 看 到 上 述 的 错误 提示 。 


现在 重新 运行 程序 ， 效 果 如 图 3.27 所 示 。 
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图 3.27 PercentFrameLayout 运 行 效果 


可 以 看 到 ， 每 一 个 按钮 的 党 和 高 都 占据 了 布局 的 50%， 这 样 我 们 就 轻松 
实现 了 4 个 按钮 平分 屏 大 的 效果 。 


PercentFrameLayout 的 用 法 束 介 绍 到 这 里 ， 男 外 一 个 
PercentRelativeLayout 的 用 法 也 是 非常 相似 的 ， 它 继承 了 RelativeLayout 
中 的 所 有 属性 ， 并 且 可 以 使 用 app:layout_widthPercent 和 
app:layout_heightPercent 来 按 百 分 比 指定 控件 的 宽 高 ， 相 信 聪 明 的 你 
一 定 可 以 举一反三 了 。 


这 样 我 们 束 把 最 党 用 的 几 种 布局 都 讲解 完了 ， 其 实 Android 中 还 有 
AbsoluteLayout、TableLayout 等 布局 ， 不 过 由 于 使 用 得 实在 是 太 少 了 ， 
就 不 在 本 书 中 进行 讲解 了 。 








区 系统 控件 不 够 用 ? 创建 自 定义 控 


在 前 面 两 节 我 们 已 经 学 习 了 Android 中 的 一 些 常用 控件 以 及 基本 布局 的 





用 法 ， 不 过 当时 我 们 并 没有 关注 这 些 控 件 和 布局 的 继承 结构 ， 现 在 是 时 
候 来 看 一 下 了 ， 如 图 3.28 所 示 。 


View 











TextView ImageView 








EditText LinearLayout 


图 3.28 ”常用 控件 和 布局 的 继承 结构 


可 以 看 到 ， 我 们 所 用 的 所 有 控件 都 是 直接 或 间接 继承 自 View 的 ， 所 用 的 
所 有 布局 都 是 直接 或 间接 继承 自 ViewGroup 的 。View 是 Android 中 最 基 
本 的 一 种 UI 组 件 ， 它 可 以 在 屏幕 上 绘制 一 块 矩形 区 域 ， 并 能 啊 应 这 块 区 
域 的 各 种 事件 ， 因 此 ， 我 们 使 用 的 各 种 控件 其 实 就 是 在 View 的 基础 之 上 
又 添加 了 各 自 特 有 的 功能 。 而 ViewGroup 则 是 一 种 特殊 的 View， 它 可 以 
售 很 多 子 View 和 子 ViewGroup， 是 一 个 用 于 放置 控件 和 布局 的 容 妖 。 


这 个 时 候 我 们 就 可 以 思考 一 下 ， 当 系统 目 带 的 控件 并 不 能 满足 我 们 的 需 














求 时 ， 可 不 可 以 利用 上 面 的 继承 结构 来 创建 自 定 义 控 件 呢 ?答案 是 肯定 
的 ， 下 面 我 们 束 来 学 习 一 下 创建 自 定 义 控件 的 两 种 简单 方法 。 先 将 准备 
工作 做 好 ， 创 建 一 个 UICustomViews 项 目 。 


3.4.1 引入 布局 


如 果 你 用 过 iPhone 应 该 会 知道 ， 几 平 每 一 个 iPhone 应 用 的 界面 项 部 都 会 
有 一 个 标题 栏 ， 标 题 栏 上 会 有 一 到 两 个 按钮 可 用 于 返回 或 其 他 操作 
(iPhone 没 有 实体 返回 键 ) 。 现 在 很 多 Android 程 序 也 都 喜欢 模仿 iPhone 
的 风格 ， 在 界面 的 顶部 放置 一 个 标题 栏 。 虽然 Android 系 统 己 经 给 每 个 
活动 提供 了 标题 栏 功能 ， 但 这 里 我 们 决定 先 不 使 用 它 ， 而 是 创建 一 个 目 
定义 的 标题 栏 。 


经 过 前 面 两 节 的 学 习 ， 相 信和 创建 一 个 标题 栏 布局 对 你 来 说 已 经 不 是 什么 
困难 的 事情 了 ， 只 需要 加 入 两 个 Button 和 一 个 TextView， 然 后 在 布局 中 
所 放 好 就 可 以 了 。 可 是 这 样 做 却 存 在 着 一 个 问题 ， 一 般 我 们 的 程序 中 可 

能 有 很 多 个 活动 都 需要 这 样 的 标题 栏 ， 如 果 在 每 个 活动 的 布局 中 都 编写 
一 换 同 样 的 标题 栏 代码 ， 明 显 束 会 导致 代码 的 大 量 重 复 。 这 个 时 候 我 们 
就 可 以 使 用 引入 布局 的 方式 来 解决 这 个 问题 ， 新 建 一 个 布局 title.xml， 
代码 如 下 所 示 : 


<LinearLayout xmlns:android="http: //schemas. android.com/apk/res/android" 
android:layout_width="match_paren 

andr oid: layout height=" "wrap_content" 
android:background="@drawable/title_bg"> 














<Button 
android:id="@+id/title_back" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center" 
android:layout_margin="5dp" 
android:background="@drawable/back_bg" 
android:text="Back" 
android:textColor="#fff" /> 





<TextView 
android:id="@+id/title_text" 
android:layout_width= "gdp" 
android:layout_height=" ‘wrap_ content" 
android:layout_gravity=" ‘Center™ 
android:1layout Weight="1 
android: gravity=" center" 
android:text="Title Text" 
android:textColor="#fff" 
android:textSize="24sp" /> 





<Button 
android:id="@+id/title_edit" 
android:layout_width= "Wrap content" 
android:layout_height=" wrap- content" 
android:layout_ gy ‘center" 
android:layout_margin="5dp" 
android: background= "@drawable/edit ， bg" 
android:text="Edit" 
android:textColor="#fff" /> 


</LinearLayout> 


可 以 看 到 ， 我 们 在 LinearLayout 中 分 别 加 入 了 两 个 Button 和 一 个 
TextView， 左 边 的 Button 可 用 于 返回 ， 右 边 的 Button 可 用 于 编辑 ， 中 间 
的 TextView 则 可 以 显示 一 段 标题 文本 。 上 面 代 码 中 的 大 多 数 属性 都 是 你 
已 经 见 过 的 ， 下 面 我 来 说 明 一 下 几 个 之 前 没有 讲 过 的 属 

性 。android:packground 用 于 为 布局 或 控件 指定 一 个 背景 ， 可 以 使 用 颜 
色 或 图 片 来 进行 填充 ， 这 里 我 提前 准备 好 了 3 张 图 片 一 一 title_ bg.png、 
back_bg.png 和 edit_bg.png， 分 别 用 于 作为 标题 栏 、 返 回 按 钮 和 编辑 按钮 
的 背景 。 另 外 ， 在 两 个 Button 中 我 们 都 使 用 了 android:layout_margin 这 
个 属性 ， 它 可 以 指定 控件 在 上 下 左右 方 同上 偏 移 的 距离 ， 当 然 也 可 以 使 
用 android: layout_margin Left 或 android: layout_marginTop 等 属性 来 单 
独 指定 控件 在 某 个 方 和 同上 偏 移 的 距离 。 


现在 标题 栏 布局 已 经 编写 完成 了 ， 剩 下 的 就 是 如 何在 程序 中 使 用 这 个 标 
题 栏 了， 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


mlns:android="http://schemas.android.com/apk/res/android" 
="match_parent" 














U height="match_parent" Es 


oid 
oid 

<include layout="@layout/title" /> 
Layout 


没 错 ! 我 们 只 需要 通过 一 行 include 语 句 将 标题 栏 布局 引入 进来 就 可 以 


最 后 别 筷 了 在 MainActivity 中 将 系统 目 带 的 标题 栏 隐藏 掉 ， 代 码 如 下 所 
小 : 


public class MainActivity extends AppCompatActivity { 


eate(save C 
setContentView(R.1layout.activity main); 
ActionBar actionbar = getSupportActionBar(); 


这 里 我 们 调用 了 getsupportActionBar() 方 法 来 获得 ActionBar 的 实例 ， 
然后 再 调用 ActionBar 的 hide() 方 法 将 标题 栏 隐藏 起 来 。 关 于 ActionBar 
的 更 多 用 法 我 们 将 会 在 第 12 章 中 讲解 ， 现 在 你 只 需要 知道 可 以 通过 这 种 
写法 来 隐藏 标题 栏 就 足够 了 。 现 在 运行 一 下 程序 ， 效 果 如 网 3.29 所 示 。 











Title Text 








图 3.29 引入 标题 栏 布局 的 效果 


使 用 这 种 方式 ， 不 管 有 多 少 布局 需要 添加 标题 柱 ， 只 第 一 行 jnclude 语 
句 就 可 以 了 。 


3.4.2 创建 自 定 义 控件 


引入 布局 的 技巧 确实 解决 了 重复 编写 布局 代码 的 问题 ， 但 是 如 果 布 局 中 
有 一 些 控 件 要 求 能 够 啊 应 事件 ， 我 们 还 是 需要 在 每 个 活动 中 为 这 些 控件 
单独 编写 一 次 事件 注册 的 代码 。 比 如 次 标题 栏 中 的 返回 按钮 ， 其 实 不 管 
征 在 哪 一 个 活动 中 ， 这 个 按钮 的 功能 都 是 相同 的 ， 即 销毁 当前 活动 。 而 
如 果 在 每 一 个 活动 中 都 需要 重新 注册 一 所 返回 按钮 的 点 击 事件 ， 无 疑 会 
增加 很 多 重复 代码 ， 这 种 情况 最 好 是 使 用 目 定 义 控件 的 方式 来 解决 。 


新 建 TitleLayout 继 承 自 LinearLayout， 让 它 成 为 我 们 自 定义 的 标题 栏 控 




















件 ， 代 码 如 下 所 示 : 


public class TitleLayout extends LinearLayout { 


public TitleLayout(Context context, AttributeSet attrs) { 
super(context, attrs); 
LayoutInflater.from(context).inflate(R.layout.title, this); 


首先 我 们 重 写 了 LinearLayout 中 带 有 两 个 参数 的 构造 函数 ， 在 布局 中 引 
入 TitleLayout 控 件 就 会 调用 这 个 构造 函数 。 然 后 在 构造 函数 中 需要 对 标 
题 栏 布局 进行 动态 加 载 ， 这 就 要 借助 LayoutInflater 来 实现 了 。 通 过 
LayoutInflater 的 from() 方 法 可 以 构建 出 一 个 LayoutInflater 对 象 ， 然 后 
调用 inflate() 方 法 就 可 以 动态 加 载 一 个 布局 文件 ，inflate() 方 法 接收 
两 个 参数 ， 第 一 个 参数 是 要 加 载 的 布局 文件 的 d， 这 里 我 们 传 入 
R.layout.title， 第 二 个 参数 是 给 加 载 好 的 布局 再 添加 一 个 父 布局 ， 这 里 
我 们 想 要 指定 为 TitleLayout， 于 是 直接 传 入 this。 


现在 自 定义 控件 已 经 创建 好 了 ， 然 后 我 们 需要 在 布局 文件 中 添加 这 
定义 控件 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_paren 
android:layout_height="match_parent" > 





<com.example.uicustomviews.TitleLayout 
android:layout_width="match_parent" 
android:layout_height="wrap_content" /> 


</LinearLayout> 





添加 自 定 义 控 件 和 添加 普通 控件 的 方式 基本 是 一 样 的 ， 只 不 过 在 添加 目 
2 我 们 需要 指明 控件 的 完整 类 名 ， 包 名 在 这 里 是 不 可 以 


ee ， 你 会 发 现 此 时 效果 和 使 用 引入 布局 方式 的 效果 是 一 样 


下 面 我 们 尝试 为 标题 栏 中 的 按钮 注册 点 击 事件 ， 修 改 TitleLayout 中 的 代 
码 ， 如 下 所 示 : 


public class TitleLayout extends LinearLayout { 











public TitleLayout(Context context, AttributeSet attrs) { 
super(context, attrs); 
LayoutInflater.from(context).inflate(R.layout.title, this); 
Button titleBack = (Button) findvViewById(R.id.title back); 
Button titleEdit = (Button) findvViewById(R.id.title edit); 
titleBack.setOonClickListener(new OncClickListener() { 


Q@override 
public void onClick(View v) { 
((Activity) getContext()).finish(); 


}); 
titleEdit.setOonClickListener(new OncClickListener() { 
@Override 
public void onClick(View v 
Toast.makeText(getContext(), "You clicked Edit button", 
Toast .LENGTH_SHORT) .show() ; 





首先 还 是 通过 findviewById() 方 法 得 到 按钮 的 实例 ， 然 后 分 别 调 

点 击 事件 ， 当 点 击 返 回 
按钮 时 销 吸 挥 当前 的 活动 ， 当 点 击 编辑 按钮 时 弹出 一 段 文本 。 重新 运 云 行 
程序 ， 点 击 一 下 编辑 按钮 ， 效 果 如 图 3.30 所 示 。 


Title Text 


You clicked Edit button 








图 3.30 点击 编辑 按钮 的 效果 


这 样 的 话 ， 每 当 我 们 在 一 个 布局 中 引入 TitleLayout 时 ， 返 回 按钮 和 编辑 
的 的 点 击 事件 就 已 经 自动 实现 好 了 ， 这 就 省 去 了 很 多 编写 重复 代码 的 
工作 。 











3.5 ”最 常用 和 最 难 用 的 控件 一 一 
ListView 


ListView 绝 对 可 以 称 得 上 是 Android 中 最 常用 的 控件 之 一 ， 几 乎 所 有 的 应 
用 程序 都 会 用 到 它 。 由 于 手机 屏幕 空间 都 比较 有 限 ， 能 够 一 次 性 在 屏幕 
上 显示 的 内 容 并 不 多 ， 当 我 们 的 程序 中 有 大 量 的 数据 需要 展示 的 时 候 ， 
就 可 以 借助 ListView 来 实现 。ListView 人 允许 用 户 通 过 手指 上 下 滑动 的 方 
式 将 屏幕 外 的 数据 滚动 到 屏幕 内 ， 同 时 屏幕 上 原 有 的 数据 则 会 滚动 出 屏 
幕 。 相 信 你 其 实 每 天 都 在 使 用 这 个 控件 ， 比 如 查看 QQ 聊天 记录 ， 翻 阅 
微 博 最 新 消息 ， 等 等 。 


不 过 比 起 前 面 介绍 的 几 种 控件 ，ListView 的 用 法 也 相对 复杂 了 很 多 ， 因 
此 我 们 就 单独 使 用 一 节 内 容 来 对 ListView 进 行 非常 详细 的 讲解 。 


3.5.1 ListView 的 简单 用 法 


首先 新 建 一 个 ListViewTest 项 目 ， 并 让 Android Studio 自 动 帮 我 们 创建 好 
活动 。 然 后 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 











xmlns:android="http://schemas.android.com/apk/res/android" 
th="match_parent" 


android yout_\ h 于 
android:layout_height="match_parent"> 


android:i 


在 布局 中 加 入 ListView 控 件 还 算 非 常 简 单 ， 先 为 ListView 指 定 一 个 id， 
然后 将 宽度 和 高 度 都 设置 为 match_parent， 这 样 ListView 也 就 占 满 了 整 
个 布局 的 空间 。 


接 下 来 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private String[] data = { "Apple", "Banana", "Orange", "Watermelon", 
"pear", " ", "pineapple", "strawberry", "Cherry" Mang 
"Apple", "Banana", "Orang nwat ", 
"Pineapple", "Strawberry", "Cherry", "Mango" }; 


verride 
protected void onCreate(Bundle savedInstanceState) { 


SetConten ew a ymein 2 

ArrayAdapter<String> adapter = new rayAdapter<String> 《 
MainActivity.this, android. R.1a 上 ut.simple_list_. Eee = data); 

evi > tView = (ListView) findViewById(R.id.1is ew); 

listView.setAdapter (adapter); 











既然 ListView 是 用 于 展示 大 量 数据 的 ， 那 我 们 就 应 该 先 将 数据 提供 好 。 
这 些 数 据 可 以 是 从 网 上 下 载 的 ， 也 可 以 是 从 数据 库 中 读 取 的 ， 应 该 视 具 
体 的 应 用 程序 场景 而 定 。 这 里 我 们 就 简单 使 用 了 一 个 data 数 组 来 测试 ， 
里 面包 含 了 很 多 水 果 的 名 称 。 


不 过 ， 数 组 中 的 数据 是 无 法 直接 传递 给 ListView 的 ， 我 们 还 需要 借助 适 
配器 来 完成 。Android 中 提供 了 很 多 适配器 的 实现 类 ， 其 中 我 认为 最 好 
用 的 就 是 ArrayAdapter。 它 可 以 通过 泛 型 来 指定 要 适 配 的 数据 类 型 ， 然 
后 在 构造 函数 中 把 要 适 配 的 数据 传 入 。ArrayAdapter 有 多 个 构造 函数 的 
重 载 ， 你 应 该 根据 实际 情况 选择 最 合适 的 一 种 。 这 里 由 于 我 们 提供 的 数 
据 都 是 字符 串 ， 因 此 将 ArrayAdapter 的 泛 型 指定 为 string， 然 后 在 
ArrayAdapter 的 构造 函数 中 依次 传 入 当前 上 下 文 、ListView 子 项 布局 的 
id， 以 及 要 适 配 的 数据 。 注 意 ， 我 们 使 用 了 
android.R.Layout.simple_list_item_1 作 为 ListView 子 项 布局 的 id， 这 
是 一 个 Android 内 置 的 布局 文件 ， 里 面 只 有 一 个 TextView， 可 用 于 简单 
地 显示 一 段 文本 。 这 样 适配器 对 象 就 构建 好 了 。 


最 后 ， 还 需要 调用 ListView 的 setAdapter() 方 法 ， 将 构建 好 的 适配器 对 
这 样 ListView 和 数据 之 间 的 关联 就 建立 完成 了 。 


现在 运行 一 下 程序 ， 效 果 如 图 3.31 所 示 。 可 以 通过 滚动 的 方式 来 查看 屏 
幕 外 的 数据 。 
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图 3.31 ListView 运 行 效果 
3.5.2 ”定制 ListView 的 界面 


只 能 显示 一 段 文本 的 ListView 实 在 是 太 单 调 了 ， 我 们 现在 就 来 对 
ListView 的 界面 进行 定制 ， 让 它 可 以 显示 更 加 丰富 的 内 容 。 


首先 需要 准备 好 一 组 图 片 ， 分 别 对 应 上 面 提供 的 每 一 种 水 末 ， 行 会 我 们 
要 让 这 些 水 果 名 称 的 劳 边 都 有 一 个 图 样 。 


接着 定义 一 个 实体 类 ， 作 为 ListView 适 配器 的 适 配 类 型 。 新 建 类 Fruit， 
代码 如 下 所 示 : 


public class Fruit { 
private String name; 
private int imagelId; 


public Fruit(String name, int imageId) { 


this.name = name; 
this.imageId = imagelId; 
} 
public String getName() { 


return name; 


public int getImageId() { 
return imageId; 
} 





Fruit 类 中 只 有 两 个 字段 ，name 表 示 水 果 的 名 字 ，imageId 表 示 水 果 对 应 
图 片 的 资源 id。 


然后 需要 为 ListView 的 子 项 指定 一 个 我 们 自 定 义 的 布局 ， 在 layout 目 录 
下 新 建 fruit_item.xml， 代 人 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="wrap_content"> 


<ImageView 
android:id="@+id/fruit_image" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" /> 


<TextView 
android:id="@+id/fruit_name" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center_vertical" 
android:layout_marginLeft="10dp" /> 





</LinearLayout> 





在 这 个 布局 中 ， 我 们 定义 了 一 个 ImageView 用 于 最 示 水 果 的 图 片 ， 又 定 
义 了 一 个 TextView 用 于 显示 水 果 的 名 称 ， 并 让 TextView 在 牌 直 方 同 上 居 
中 显示 。 


接 下 来 需要 创建 一 个 自 定义 的 适配器 ， 这 个 适配器 继承 自 
ArrayAdapter, 并 将 泛 型 指定 为 Fruit 美 。 i 代码 如 
下 所 示 : 


public class FruitAdapter extends ArrayAdapter<Fruit> { 





private int resourceId ; 


public FruitAdapter(Context context, int textViewResourceId， 
List<Fruit> objects) { 
super(context, textViewResourceId, objects); 
resourceId = textViewResourceId; 


@override 

public View getView(int position, View convertView, ViewGroup parent) { 
Fruit fruit = getItem(position); // 获取 当前 项 的 Fruit 实 例 
View view = LayoutInflater.from(getContext()).inflate(resourceId，parent， 

false); 

ImageView fruitImage = (ImageView) view.findViewById(R.id.fruit_ image); 
TextView fruitName = (TextView) view.findViewById(R.id.fruit_name); 
fruitImage.setImageResource(fruit.getIimageId()); 
fruitName.setText(fruit.getName()); 
return view; 


FruitAdapter 章 写 了 父 类 的 一 组 构造 函数 ， 用 于 将 上 下 文 、ListView 子 
项 布局 的 id 和 数据 都 传递 进来 。 男 外 又 重 写 了 getview() 方 法 ， 这 个 方法 
在 每 个 子 项 被 滚动 到 屏幕 内 的 时 候 会 被 调用 。 在 getview() 方 法 中 ， 首 
先 通 过 getItem() 方 法 得 到 当前 项 的 Fruit 实 例 ， 然 后 使 用 LayoutInflater 
来 为 这 个 子 项 加 载 我 们 传 入 的 布局 。 


这 里 LayoutInflater 的 inflate() 方 法 接收 3 个 参数 ， 前 两 个 参数 我 们 已 
经 知道 是 什么 意思 了 ， 第 三 个 参数 指定 成 false， 表 示 只 让 我 们 在 父 布 
局 中 声明 的 layout 属 性 生效 ， 但 不 会 为 这 个 View 添 加 父 布 局 ， 因 为 一 旦 
View 有 了 父 布局 之 后 ， 它 就 不 能 再 添加 到 ListView 中 了 。 如 果 你 现在 还 
不 能 理解 这 上 段 话 的 含义 也 没关系 ， 只 需要 知道 这 是 ListView 中 的 标准 写 
法 束 可 以 了 ， 当 你 以 后 对 View 理 解 得 更 加 深刻 的 时 候 ， 再 来 读 这 上 段 话 就 
没有 问题 了 。 


我 们 继续 往 下 看 ， 接 下 来 调用 View 的 findviewById() 方 法 分 别 获取 到 
ImageView 和 TextView 的 实例 ， 并 分 别 调用 它们 的 setImageResource() 
和 setText() 方 法 来 设置 显示 的 图 片 和 文字 ， 最 后 将 布局 返回 ， 这 样 我 
们 自 定义 的 适配器 就 完成 了 。 

下 面 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 











private List<Fruit> fruitList = new ArrayList<>(); 


@override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceSstate); 
setContentView(R.1layout.activity main); 
initFruits(); // 初始 化 水 果 数 据 
FruitAdapter adapter = new FruitAdapter (MainActivity.this, 

R.layout.fruit_item, fruitList); 

ListView listView = (ListView) findViewById(R.id.1ist_ view); 
listView.setAdapter (adapter); 

} 


private void initFruits() { 

For (int: TS 0 Ad.< 2 it+ 
Fruit apple = new Fruit("Apple", R.drawable.apple_pic); 
fruitList.add(apple); 
Fruit banana = new Fruit("Banana", R.drawable.banana_pic); 
fruitList.add(banana); 
Fruit orange = new Fruit("Orange", R.drawable.orange_pic); 
fruitList.add(orange); 
Fruit watermelon = new Fruit("wWatermelon", R.drawable.watermelon_pic); 
fruitList.add(watermelon); 
Fruit pear = new Fruit("Pear", R.drawable.pear_pic); 
fruitList.add(pear); 
Fruit grape = new Fruit("Grape", R.drawable.grape_pic); 
fruitList.add(grape); 
Fruit pineapple = new Fruit("Pineapple", R.drawable.pineapple_pic); 
fruitList.add(pineapple); 
Fruit strawberry = new Fruit("Strawberry", R.drawable.strawberry_pic); 
fruitList.add(strawberry); 
Fruit cherry = new Fruit("Cherry", R.drawable.cherry_pic); 
fruitList.add(cherry); 





new Fruit("Mango", R.drawable.mango_pic); 
Fe St Bad ia go); 
3 
} 


} 


可 以 看 到 ， 这 里 添加 了 一 个 initFruits() 方 法 ， 用 于 初始 化 所 有 的 水 果 
数据 。 在 Fruit 类 的 构造 函数 中 将 水 果 的 名 字 和 对 应 的 图 片 id 传 入 ， 然 后 
把 创建 好 的 对 象 添加 到 水 果 列 表 中 。 另 外 我 们 使 用 了 一 个 for 循 环 将 所 
有 的 水 果 数 据 添 加 了 两 裔 ， 这 是 因为 如 果 只 添加 一 裔 的 话 ， 数 据 量 还 不 
足以 充满 整个 屏幕 。 接 着 在 oncreate( ) 方 法 中 创建 了 FruitAdapter 对 
象 ， 并 将 FruitAdapter 作 为 适配器 传递 给 ListView， 这 样 定 制 ListView 界 
面 的 任务 就 完成 了 。 


现在 重新 运行 程序 ， 效 果 如 图 3.32 所 示 。 
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图 3.32 ”定制 界面 的 ListView 运 行 效 果 


虽然 目前 我 们 定制 的 界面 还 很 简单 ， 但 是 相信 聪明 的 你 已 经 领悟 到 了 诀 
窒 ， 只 要 修改 fruit_item.xml 中 的 内 容 ， 束 可 以 定制 出 各 种 复杂 的 界面 


3.5.3 ”提升 ListView 的 运行 效率 


之 所 以 说 ListView 这 个 控件 很 难 用 ， 就 是 因为 它 有 很 多 细节 可 以 优化 ， 
其 中 运行 效率 就 是 很 重要 的 一 点 。 目 前 我 们 ListView 的 运行 效率 是 很 低 
的 ， 因 为 在 FruitAdapter 的 getview() 方 法 中 ， 每 次 都 将 布局 重新 加 载 了 
一 遍 ， 当 ListView 快 速 滚动 的 时 候 ， 这 就 会 成 为 性 能 的 瓶颈 。 


仔细 观察 会 发 现 ，getview() 方 法 中 还 有 一 个 convertVview 参 数 ， 这 个 参 
数 用 于 将 之 前 加 载 好 的 布局 进行 缓存 ， 以 便 之 后 可 以 进行 重用 。 修 
改 FruitAdapter 中 的 代码 ， 如 下 所 示 : 


public class FruitAdapter extends ArrayAdapter<Fruit> { 














@override 

public View getView(int position, View convertView, ViewGroup parent) { 
Fruit fruit = getItem(position); 
View view; 


if (convertView == null) { 
view = LayoutInflater.from(getContext()).inflate(resourceId, parent, 
false); 
} else { 


VvView = convertView; 


ImageView fruitImage = (ImageView) view.findViewById(R.id.fruit_ image); 
TextView fruitName = (TextView) view.findViewById(R.id.fruit_name); 
fruitImage.setImageResource(fruit.getImageId()); 
fruitName.setText(fruit.getName()); 

return view; 


可 以 看 到 ， 现 在 我 们 在 getview( ) 方 法 中 进行 了 判断 ， 如 果 convertview 
为 nul1， 则 使 用 LayoutInflater 去 加 载 布局 ， 如 果 不 为 nul1 则 直接 对 
convertVview 进 行 重用 。 这 样 就 大 大 提高 了 ListView 的 运行 效率 ， 在 快速 
滚动 的 时 候 也 可 以 表现 出 更 好 的 性 能 。 


不 过 ， 目 前 我 们 的 这 份 代 码 还 是 可 以 继续 优化 的 ， 虽 然 现 在 已 经 不 会 再 
重复 去 加 载 布 局 ， 但 是 每 次 在 getview() 方 法 中 还 是 会 调用 view 的 
findviewById() 方 法 来 获取 一 次 控件 的 实例 。 我 们 可 以 借助 一 

个 viewHolder 来 对 这 部 分 性 能 进行 优化 ， 修 改 FruitAdapter 中 的 代码 ， 
如 下 所 示 : 


public class FruitAdapter extends ArrayAdapter<Fruit> { 











@override 
public View getView(int position, View convertView, ViewGroup parent) { 
Fruit fruit = getItem(position); 
View view; 
ViewHolder viewHolder; 
if (convertView == null) { 
view = LayoutInflater.from(getContext()).inflate(resourceId, parent, 
false); 
viewHolder = new ViewHolder(); 
viewHolder .fruitImage = (ImageView) view.findViewById 
(R.id.fruit_image); 
viewHolder .fruitName = (TextView) view.findViewById (R.id.fruit_name); 
view.setTag(viewHolder); // 将 ViewHolder 存 储 在 View 中 
} else { 
View = convertView; 
viewHolder = (ViewHolder) view.getTag(); // 重新 获取 ViewHolder 








} 
viewHolder .fruitImage.setImageResource(fruit.getImageId()); 
viewHolder.fruitName.setText(fruit.getName()); 

return view; 


} 
class ViewHolder { 
ImageView fruitImage; 


TextView fruitName; 


我 们 新 增 了 一 个 内 部 类 viewholder， 用 于 对 控件 的 实例 进行 缓存 。 
当 convertview 为 nul1 的 时 候 ， 创 建 一 个 viewHolder 对 象 ， 并 将 控件 的 实 
例 都 存放 在 viewHolder 里 ， 然 后 调用 view 的 setTag() 方 法 ， 

将 viewHolder 对 象 存储 在 view 中 。 当 convertview 不 为 nul1 的 时 候 ， 则 调 
用 view 的 getTag() 方 法 ， 把 viewHolder 重 新 取出 。 这 样 所 有 控件 的 实例 
都 组 存在 了 viewHolder 里 ， 就 没有 必要 每 次 都 通过 findviewById( ) 方 法 





来 获取 控件 实例 了 。 





通过 这 两 步 优 化 之 后 ， 我 们 ListView 的 运行 效率 就 已 经 非常 不 错 了 。 


3.5.4 ”ListView 的 点 击 事 件 





话说 回来 ，ListView 的 滚动 毕竟 只 是 满足 了 我 们 视觉 上 的 效果 ， 可 是 如 





果 ListView 中 的 子 项 不 能 点 击 的 话 ， 这 个 控件 就 没有 什么 实际 的 用 途 
了 。 因 此 ， 本 小 市 我 们 就 来 学 习 一 下 ListView 如 何 才 能 咽 应 用 户 的 点 击 


修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private List<Fruit> fruitList = new ArrayList<>(); 


@Ooverride 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity main); 
initFruits(); 
FruitAdapter adapter = new FruitAdapter (MainActivity.this, R.1layout. 
fruit_item, fruitList); 





ListView listView = (ListView) findViewById(R.id.]1ist_view); 
listView.setAdapter (adapter); 
listView.setOnItemClickListener(new AdapterView.OnItemClickListener() { 
@Override 
public void OnItemClick(AdapterView<?> parent, View view, 
int position, long id) 
Fruit fruit = fruitList.get(position); 
Toast.makeText (MainActivity.this, fruit.getName(), 
Toast .LENGTH_SHORT). show( ); 


可 以 看 到 ， 我 们 使 用 setonItemclickListener() 方 法 为 ListView 注 册 了 
一 个 监听 器 ， 当 用 户 点 击 了 ListView 中 的 任何 一 个 子 项 时 ， 就 会 回 

调 onItemclick() 方 法 。 在 这 个 方法 中 可 CO ee 
点 击 的 是 哪 一 个 子 项 ， 然 后 获取 到 相应 的 水 果 ， 并 通过 Toast 将 水 果 的 
名 字 显 示 出 来 。 


重新 运行 程序 ， 并 点 击 一 下 橘子 ， 效 果 如 图 3.33 所 示 。 
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图 3.33 点 击 ListView 的 效果 


3.6 更 强大 的 深 动 控件 一 一 
RecyclerView 


ListView 由 于 其 强大 的 功能 ， 在 过 去 的 Android 开 发 当中 可 以 说 是 贡献 卓 
越 ， 直 到 今天 仍然 还 有 不 计 其 数 的 程序 在 继续 使 用 着 ListView。 不 过 
ListView 并 不 是 完全 没有 缺点 的 ， 比 如 说 如 果 我 们 不 使 用 一 些 技巧 来 提 
升 它 的 运行 效率 ， 那 么 ListView 的 性 能 就 会 非常 差 。 还 有 ，ListView 的 
扩展 性 也 不 够 好 ， 它 只 能 实现 数据 纵向 滚动 的 效果 ， 如 果 我 们 想 实 现 横 
向 滚动 的 话 ，ListView 是 做 不 到 的 。 


为 此 ，Android 提 供 了 一 个 更 强大 的 深 动 控件 一 一 RecyclerView。 它 可 以 
说 是 一 个 增强 版 的 ListView， 不 仅 可 以 轻松 实现 和 ListView 同 样 的 效 

果 ， 还 优化 了 ListView 中 存在 的 各 种 不 足 之 处 。 目 前 Android 官 方 更 加 推 
荐 使 用 RecyclerView， 未 来 也 会 有 更 多 的 程序 逐渐 从 ListView 转 回 
RecyclerView， 那 么 本 节 我 们 就 来 详细 讲解 一 下 RecyclerView 的 用 法 。 


首先 新 建 一 个 RecyclerViewTest 项 目 ， 并 让 Android Studio 目 动 帮 我 们 创 
建 好 活动 。 

3.6.1 。 RecyclerView 的 基本 用 法 

和 百分比 布局 类 似 ，RecyclerView 也 属于 新 增 的 控件 ， 为 了 让 
RecyclerView 在 所 有 Android 版 本 上 都 能 使 用 ，Android 团 队 采 取 了 同样 
的 方式 ， 将 RecyclerView 定 义 在 了 support 库 当中 。 因 此 ， 想 要 使 用 


RecyclerView 这 个 控件 ， 首 先 需 要 在 项 目的 build.gradle 中 添加 相应 的 依 
赖 库 才 行 。 


打开 app/build.gradle 文 件 ， 在 dependencies 闭 包 中 添加 如 下 内 容 : 











"ibs ,includes sr] 
ndroid.support:appcompat-v7:24.2.1" 
compile 'com.android.support:recyclerview-v7:24.2.1' 
testCompile 'junit:junit:4.12'" 


添加 完 之 后 记得 要 扣 击 一 下 Sync Now 来 进行 同步 。 然 后 修改 


activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android.support.v7.widget.RecyclerView 
android:id="@+id/recycler_view" 
android:layout_width="match_parent" 
android:layout_height="match_parent" /> 


</LinearLayout> 


在 布局 中 加 入 RecyclerView 控 件 也 是 非常 简单 的 ， 先 为 RecyclerView 指 
定 一 个 id， 然 后 将 宽度 和 高 度 都 设置 为 mnatch_parent， 这 样 
RecyclerView 也 就 占 满 了 整个 布局 的 空间 。 需 要 注意 的 是 ， 由 于 
ee 内 置 在 系统 SDK 当 中 的 ， 所 以 需要 把 完整 的 包 路 径 
GD 


这 里 我 们 想 要 使 用 RecyclerView 来 实现 和 ListView 相 同 的 效果 ， 因 此 就 

需要 准备 一 份 同样 的 水 果 图 片 。 简 单 起 见 ， 我 们 就 直接 从 ListViewTest 

项 目 中 把 网 请 复 制 过 来 束 可 以 了 ， 另 外 顺便 将 Fruit 类 和 fruit_item.xml 也 
复制 过 来 ， 省 得 将 同样 的 代码 再 写 一 过 。 

接 下 来 需要 为 RecyclerView 准 备 一 个 适配器 ， 新 建 FruitAdapter 类 ， 让 

这 个 适配器 继承 自 RecyclerView.Adapter， 并 将 泛 型 指定 

为 FruitAdapter .ViewHolder。 其 中 ， ViewHolder 是 我 们 在 FruitAdapter 


中 定义 的 一 个 内 部 类 ， 代 码 如 下 所 示 : 


public class FruitAdapter extends RecyclerView.Adapter<FruitAdapter.ViewHolder> { 





private List<Fruit> mFruitList; 


static class ViewHolder extends RecyclerView.ViewHolder { 
ImageView fruitImage; 
TextView fruitName; 


public ViewHolder (View view) { 
super (view); 
fruitImage = (ImageView) view.findViewById(R.id.fruit_ image); 
fruitName = (TextView) view.findViewById(R.id.fruit_name); 
} 
} 


public FruitAdapter(List<Fruit> fruitList) { 
mFruitList = fruitList; 


@override 
public ViewHolder onCreateViewHolder (ViewGroup parent, int viewType) { 
View view = LayoutInflater.from(parent .getContext()) 
.inflate(R.layout.fruit_item, parent, false); 
ViewHolder holder = new ViewHolder (view); 
return holder; 
} 


@override 

public void onBindViewHolder (ViewHolder holder, int position) { 
Fruit fruit = mFruitList.get(position); 
holder .fruitImage.setImageResource(fruit.getImageId()); 
holder .fruitName.setText(fruit.getName()); 


} 


@Override 


public int getItemCount() { 
return mFruitList.size(); 
} 


虽然 这 段 代码 看 上 去 好 像 有 点 长 ， 但 其 实 它 比 ListView 的 适 配 右 要 更 容 
易 理 解 。 这 里 我 们 首先 定义 了 一 个 内 部 类 ViewHolder，vViewHolder 要 继 
承 自 RecyclerView， ViewHolder。 然后 viewHolder 的 构造 函数 中 要 传 入 一 
个 view 参 数 ， 这 个 参数 通 冲 就 是 RecyclerView 丁 项 的 最 外 层 布局 ， 那 么 
我 们 就 可 以 通过 findviewById() 方 法 来 获取 到 布局 中 的 ImageView 和 
TextView 的 实例 了 。 


接 看 往 下 看 ，FruitAdapter 中 也 有 一 个 构造 函数 ， 这 个 方法 用 于 把 要 展 
示 的 数据 源 传 进来 ， 并 赋值 给 一 个 全 局 变量 mFruitList， 我 们 后 续 的 操 
作 都 将 在 这 个 数据 源 的 基础 上 进行 。 


继续 往 下 看 ， 由 于 FruitAdapter 是 继承 自 Recyclerview.Adapter 的 ， 那 
么 就 必须 重 写 oncreateviewHolder()、onBindviewHolder() 和 
detItemCount( j} 这 3 个 方法 。 onCreateViewHolder( ) 方 法 是 用 
ViewHolder 实 例 的 ， 我 们 在 这 个 方法 中 将 fruit_item 布 局 加 载 进 来 ， 然 
后 创建 一 个 viewHolder 实 例 ， rt 
中 ， 最 后 将 viewHolder 的 实例 返回 。onBindViewHolder() 方 法 是 用 于 对 
RecyclerView 子 项 的 数据 进行 赋值 的 ， 会 在 每 个 子 项 被 滚动 到 屏 > 内 的 
时 候 执 行 ， 这 里 我 们 通过 position 参 数 得 到 当前 项 的 Fruit 实 例 ， 然 后 
再 将 数据 设置 到 viewHolder 的 ImageView 和 TextView 当 中 即 

可 。getItemcount () 方 法 就 非常 简单 了 ， 它 用 于 告诉 RecyclerView 一 共 
有 多 少子 项 ， 直 接 返 回 数据 源 的 长 度 就 可 以 了 。 


适配器 准备 好 了 之 后 ， 我 们 束 可 以 开始 使 用 RecyclerView 了， 修改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 














private List<Fruit> fruitList = new ArrayList<>(); 


@override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedIinstanceState); 
setContentView(R.1layout.activity main); 
initFruits(); // 初始 化 水 果 数 据 
RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recycler_view); 
LinearLayoutManager layoutManager = new LinearLayoutManager(this); 
recyclerView.setLayoutManager (layoutManager); 
FruitAdapter adapter = new FruitAdapter(fruitList); 
recyclerView.setAdapter (adapter); 


} 


private void initFruits() { 
for (int i = 0; i < 2; I++ 
Fruit apple = new Fruit("Apple", R.drawable.apple_pic); 
FruitLit dd(appie 和 
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fruit 
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Fruit 
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fruit 


可 以 看 到 ， 这 里 使 用 了 一 个 同样 的 initFruits() 方 法 ， 用 于 初始 化 所 有 
的 水 果 数 据 。 接 着 在 oncreate() 方 法 中 我 们 先 获 取 到 RecyclerView 的 实 
例 ， 然 后 创建 了 一 个 LinearLayoutManager 对 象 ， 并 将 它 设 置 到 
RecyclerView 当 中 。LayoutManager 用 于 指定 RecyclerView 的 布局 方式 ， 
这 里 使 用 的 LinearLayoutManager 是 线性 布局 的 意思 ， 可 以 实现 和 
ListView 类 似 的 效果 。 接 下 来 我 们 创建 了 FruitAdapter 的 实例 ， 并 将 水 
条 数据 传 入 到 FruitAdapter 的 构造 函数 中 ， 最 后 调用 RecyclerView 的 
setAdapter() 方 法 来 完成 适配器 设置 ， 这 样 RecyclerView 和 数据 之 间 的 


banana = new Fruit("Banana", R.drawable.banana_pic); 


List.add(banana); 


orange = new Fruit("Orange", R.drawable.orange_pic); 


List.add(orange); 


watermelon = new Fruit("wWatermelon", R.drawable.watermelon_pic); 


List.add(watermelon); 


pear = new Fruit("Pear", R.drawable.pear_pic); 


List.add(pear); 


grape = new Fruit("Grape", R.drawable.grape_pic); 


List.add(grape); 


pineapple = new Fruit("Pineapple", R.drawable.pineapple_pic); 


List.add(pineapple); 


strawberry = new Fruit("Strawberry", R.drawable.strawberry_pic); 


List.add(strawberry); 


cherry = new Fruit("Cherry", R.drawable.cherry_pic); 


List.add(cherry); 


mango = new Fruit("Mango", R.drawable.mango_pic); 


List.add(mango); 


关联 就 建立 完成 了 。 








现在 可 以 运行 一 下 程序 了 ， 效 果 如 图 3.34 所 示 。 


RecyclerViewTest 


本 








图 3.34 RecyclerView 运 行 效果 


可 以 看 到 ， 我 们 使 用 RecyclerView 实 现 了 和 ListView 几 乎 一 模 一 样 的 效 
果 ， 虽 说 在 代码 量 方面 并 没有 明显 地 减少 ， 但 是 逻辑 变 得 更 加 清晰 了 。 
当然 这 只 是 RecyclerView 的 基本 用 法 而 已 ， 接 下 来 我 们 就 看 一 看 
RecyclerView 还 能 实现 哪些 ListView 实 现 不 了 的 效果 。 

3.6.2 ”实现 横 问 滚动 和 瀑布 流 布局 

我 们 已 经 知道 ，ListView 的 扩展 性 并 不 好 ， 它 只 能 实现 纵 同 深 动 的 效 
果 ， 如 果 想 进行 横向 深 动 的 话 ，ListView 就 做 不 到 了 。 那 么 
RecyclerView 束 能 做 得 到 吗 ? 当然 可 以 ， 不 仅 能 做 得 到 ， 还 非常 简单 ， 
那么 接 下 来 我 们 就 尝试 实现 一 下 横向 滚动 的 效果 。 


首先 要 对 fruit_item 布 局 进行 修改 ， 因 为 目前 这 个 布局 里 面 的 元 素 是 水 





平 排列 的 ， 适 用 于 纵 同 深 动 的 场景 ， 而 如 果 我 们 要 实现 横 同 深 动 的 话 ， 
应 该 把 fruit_item 里 的 元 了 素 改 成 垂直 排列 才 比 较 合 理 。 修 改 
fruit item.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns: android= "http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="100dp" 
android:layout_height="wrap_content" > 
<ImageView 
android:id="@+id/fruit_image" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center_horizontal" /> 
<TextView 
android:id="@+id/fruit_name" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center_horizontal" 
android:layout_marginTop="10dp" /> 


</LinearLayout> 


可 以 看 到 ， 我 们 将 LinearLayout 改 成 垂直 方 同 排列 ， 并 把 宽度 设 为 
100dp。 这 里 将 宽度 指定 为 固定 值 是 因为 每 种 水 果 的 文字 长 度 不 一 致 ， 
如 果 用 wrap_content 的 话 ， RecyclerView 的 子 项 束 会 有 长 有 短 ， 非 常 不 
美观 ;而 如 果 用 match_parent 的 话 ， 就 会 导致 宽度 过 长 ， 一 个 子 项 占 满 
整个 屏幕 。 


然后 我 们 将 ImnageView 和 TextView 都 设置 成 了 在 布局 了 中 ， 并 且 
使 用 layout_marginTop 属 性 让 文字 和 图 片 之 间 保 持 一 些 距离 


接 下 来 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 





private List<Fruit> fruitList = new ArrayList<>(); 


@override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity main); 
initFruits(); 
RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recycler_view); 
LinearLayoutManager layoutManager = new LinearLayoutManager (this); 
layoutManager .setOrientation(LinearLayoutManager .HORIZONTAL); 
recyclerView.setLayoutManager (layoutManager); 
FruitAdapter adapter = new FruitAdapter(fruitList); 
recyclerView.setAdapter (adapter); 


MainActivity 中 只 加 入 了 一 行 代码 ， 调 用 LinearLayoutManager 的 
setorientation( ) 方 法 来 设置 布局 的 排列 方向 ， 默 认 是 纵 同 排列 的 ， 我 
们 传 入 LinearLayoutManager .HORIZONTAL 表 示 让 布局 横行 排列 ， 这 样 
RecyclerView 就 可 以 横 辣 滚动 了 。 





重新 运行 一 下 程序 ， 效 果 如 图 3.35 所 示 。 
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图 3.35 ”横生 RecyclerView 效 果 
你 可 以 用 手指 在 水 平方 向 上 清 动 来 查看 屏幕 外 的 数据 。 


为 什么 ListView 很 难 或 者 根本 无 法 实现 的 效果 在 RecyclerView 上 这 么 轻 
松 就 能 实现 了 呢 ? 这 主要 得 益 于 RecyclerView 出 色 的 设计 。ListView 的 
布局 排列 是 由 目 身 去 管理 的 ， 而 RecyclerView 则 将 这 个 工作 交 给 了 
LayoutManager，LayoutManager 中 制定 了 一 套 可 扩展 的 布局 排列 接口 ， 
要 按照 接口 的 规范 来 实现 ， 就 能 定制 出 各 种 不 同 排列 方式 的 布局 








除了 LinearLayoutManager 之 外 ，RecyclerView 还 给 我 们 提供 了 
GridLayoutManager 和 StaggeredGridLayoutManager 这 两 种 内 置 的 布局 排 


列 方式 。GridLayoutManager 可 以 用 于 实现 网 格 布局 ， 
StaggeredGridLayoutManager 可 以 用 于 实现 瀑布 流 布 局 。 这 里 我 们 来 实 
现 一 下 效 末 更 加 炫 酷 的 瀑布 流 布 局 ， 网 格 布局 就 作为 谍 后 习题 ， 交 给 你 
自己 来 研究 了 。 


首先 还 是 来 修改 一 下 fruit_item.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height=" wrap_content" 
android:layout_margin="5dp" > 











<ImageView 
android:id="@+id/fruit_image" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center_horizontal" /> 
<TextView 
android:id="@+id/fruit_name" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="left" 
android:layout_marginTop="10dp" /> 


</LinearLayout> 


这 里 做 了 几 处 小 的 调整 ， 首先 将 LinearLayout 的 宽度 由 100dp 改 成 了 
match_parent， 因 为 瀑布 流 布局 的 宽度 应 该 是 根据 布局 的 列 数 来 自动 适 
配 的 ， 而 不 是 一 个 固定 值 。 另 外 我 们 使 用 了 layout_ margin 属 性 来 让 子 
项 之 间 互 留 一 点 间距 ， 这 样 束 不 至 于 所 有 子 项 都 紧 贴 在 一 些 。 还 有 就 是 
将 TextView 的 对 齐 属性 改 成 了 居 左 对 齐 ， 因为 待 会 我 们 会 将 文字 的 长 度 
变 长 ， 如 果 还 是 居中 显示 就 会 感觉 怪 怪 的 。 


接着 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 




















private List<Fruit> fruitList = new ArrayList<>(); 


@Ooverride 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity main); 
initFruits(); 
RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recycler_view); 
StaggeredGridLayoutManager layoutManager = new 
StaggeredGridLayoutManager(3, StaggeredGridLayoutManager .VERTICAL); 
recyclerView.setLayoutManager (layoutManager); 
FruitAdapter adapter = new FruitAdapter(fruitList); 
recyclerView.setAdapter (adapter); 


} 


private void initFruits() { 
Tor £1int 和 主 , 三 坦 六 生生 2 二) 下 
Fruit apple = new Fruit( 
getRandomLengthName("Apple"), R.drawable.apple_pic); 
fruitList.add(apple); 
Fruit banana = new Fruit( 
getRandomLengthName("Banana"), R.drawable.banana_pic); 
fruitList.add(banana); 
Fruit orange = new Fruit( 
getRandomLengthName("Orange"), R.drawable.orange_pic); 
fruitList.add(orange); 
Fruit watermelon = new Fruit( 
getRandomLengthName("Watermelon"), R.drawable.watermelon_pic); 
fruitList.add(watermelon); 


Fruit pear = new Fruit( 

getRandomLengthName("Pear"), R.drawable.pear_pic); 
fruitList.add(pear); 
Fruit grape = new Fruit 
getRandomLengthName("Grape"), R.drawable.grape_pic); 
fruitList.add(grape); 
Fruit pineapple = new Fruit( 
getRandomLengthName("Pineapple"), R.drawable.pineapple_pic); 
fruitList.add(pineapple); 
Fruit strawberry = new Fruit 
getRandomLengthName("Strawberry"), R.drawable.strawberry_pic); 
fruitList.add(strawberry); 
Fruit cherry = new Fruit 
getRandomLengthName("Cherry"), R.drawable.cherry_pic); 
fruitList.add(cherry); 
Fruit mango = new Fruit 
getRandomLengthName("Mango"), R.drawable.mango_pic); 
fruitList.add(mango); 


} 














} 


private String getRandomLengthName(String name ) { 
Random random = new Random 
int length = random. nextInt (20) + 1; 
StringBuilder builder = new 和 
for (int i = 0; i < length; i++) { 
builder. append (name); 


} 
return builder.toString(); 


首先 ， 在 oncreate() 方 法 中 ， 我 们 创建 了 一 

个 staggered6ridLayoutManager 的 实例 。 staggeredGridLayoutManager 的 
构造 函数 接收 两 个 参数 ， 第 一 个 参数 用 于 指定 布局 的 列 数 ， 传 入 3 表示 
会 把 布局 分 为 3 列 ;第 二 个 参数 用 于 指定 布局 的 排列 方向 ， 传 

入 StaggeredGridLayoutManager .VERTICAL 表 示 会 让 布局 纵向 排列 ， 最 后 
再 把 创建 好 的 实例 设置 到 RecyclerView 当 中 就 可 以 了 ， 就 是 这 么 简单 ! 


， 仪 仪 修改 了 一 行 代 码 ， 我 们 就 已 经 成 功 实 现 汉 布 流 布 局 的 效果 
i 要 各 个 子 项 的 高 度 不 一 2 E 看 出 明显 的 效 
果 ， 为 此 我 义 使 用 了 一 个 小 技巧 。 这 里 我 们 把 眼光 聚焦 
在 getRandomLengthName( A 这 个 方法 使 用 了 Random 对 象 来 创 
造 一 个 1 到 20 之 间 的 随机 数 ， 然 后 将 参数 中 传 入 的 字符 串 随机 重复 几 
裔 。 在 initFruits() 方 法 中 ， 每 个 水 果 的 名 字 都 改 成 调 
用 getRandomLengthName( ) 这 个 方法 来 生成 ， 这 样 就 能 保证 各 水 果 名 字 的 
长 短 差距 都 比较 大 ， 子 项 的 高 上 度 也 就 各 不 相同 了 。 


现在 重新 运行 一 下 程序 ， 效 果 如 图 3.36 所 示 。 
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图 3.36 ”瀑布 流 布 局 效果 


当然 由 于 水 果 名 字 的 长 度 每 次 都 是 随机 生成 的 ， 你 运行 时 的 效果 肯定 和 
图 中 还 是 不 一 样 的 。 


3.6.3 ”RecyclerView 的 点 击 事件 


和 ListView 一 样 ，RecyclerView 也 必须 要 能 啊 应 点 击 事件 才 可 以 ， 不 然 
的 话 就 没什么 实际 用 途 了。 不 过 不 同 于 ListView 的 是 ，RecyclerView 并 
没有 提供 类 似 于 setonItemclickListener() 这 样 的 注册 监听 器 方法 ， 而 
是 需要 我 们 自己 给 子 项 具体 的 View 去 注册 点 击 事 件 ， 相 比 于 ListView 来 
说 ， 实 现 起 来 要 复杂 一 些 。 


那么 你 可 能 就 有 疑问 了 ， 为 什么 RecyclerView 在 各 方面 的 设计 都 要 优 于 
ListView， 偏 偏 在 点 击 事件 上 却 没有 处 理 得 非常 好 呢 ? 其 实 不 是 这 样 








的 ，ListView 在 点 击 事件 上 的 处 理 并 不 人 性 

化 ， setonItemCclickListener() 方 法 注册 的 是 子 项 的 点 击 事件 ， 但 如 果 
我 想 点 击 的 是 子 项 里 具体 的 某 一 个 按钮 呢 ? 虽然 ListView 也 是 能 做 到 
的 ， 但 是 实现 起 来 就 相对 比较 及 烦 了 。 为 此 ，RecyclerView 干 脆 直 接 握 
弃 了 子 项 点 击 事件 的 监 昕 器 ， 所 有 的 点 击 事件 都 由 具体 的 View 去 注册 ， 
就 再 没有 这 个 困扰 了 。 


下 面 我 们 来 具体 学 习 一 下 如 何在 RecyclerView 中 注册 点 击 事件 ， 修 
改 FruitAdapter 中 的 代码 ， 如 下 所 示 : 


public class FruitAdapter extends RecyclerView.Adapter<FruitAdapter.ViewHolder> { 














private List<Fruit> mFruitList; 


static class ViewHolder extends RecyclerView.ViewHolder { 
View fruitView; 
ImageView fruitImage; 
TextView fruitName; 


public ViewHolder (View view) { 
super (view); 
fruitView = view; 
fruitImage = (ImageView) view.findViewById(R.id.fruit_ image); 
fruitName = (TextView) view.findViewById(R.id.fruit_name); 
} 
下 


public FruitAdapter(List<Fruit> fruitList) { 
mFruitList = fruitList; 


@override 
public ViewHolder onCreateViewHolder (ViewGroup parent, int viewType) { 
View view = LayoutIinflater.from(parent.getContext()).inflate(R.1layout. 
fruit_item, parent, false); 
final ViewHolder holder = new ViewHolder (view); 
holder .fruitView.setOonClickListener(new View.OnClickListener() { 
@override 
public void onClick(View v) { 
int position = holder.getAdapterPosition(); 
Fruit fruit = mFruitList.get(position); 
Toast.makeText(v.getContext(), "you clicked view " + fruit.getName(), 
Toast .LENGTH_SHORT) .show() ; 
} 


}); 
holder .fruitImage.setOonCclickListener(new View.OnClickListener() { 
@Ooverride 
public void onClick(View v) { 
int position = holder.getAdapterPosition(); 
Fruit fruit = mFruitList.get(position); 
Toast.makeText(v.getContext(), "you clicked image " + fruit.getName(), 
Toast .LENGTH_SHORT) .show() ; 
} 


}); 
return holder; 


} 


我 们 先是 修改 了 viewHolder， 在 viewHolder 中 添加 了 fruitview 变 量 来 保 
存 子 项 最 外 层 布 局 的 实例 ， 然 后 在 oncreateviewHolder() 方 法 中 注册 点 
击 事件 就 可 以 了 。 这 里 分 别 为 最 外 层 布 局 和 ImageView 都 注册 了 点 击 事 
件 ，RecyclerView 的 强大 之 处 也 在 这 里 ， 它 可 以 轻松 实现 子 项 中 任意 控 
件 或 布局 的 点 击 事件 。 我 们 在 两 个 点 击 事 件 中 先 获取 了 用 户 点 击 的 

position， 然 后 通过 position 拿 到 相应 的 Fruit 实 例 ， 再 使 用 Toast 分 别 弹 出 

















两 种 不 同 的 内 容 以 示 区 别 。 


现在 重新 运行 代码 ， 并 点 击 香 蓄 的 图 片 部 分 ， 效 果 如 图 3.37 所 示 。 可 以 
看 到 ， 这 时 触发 了 ImageView 的 点 击 事件 。 
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图 3.37 点 击 香 蓄 的 图 片 部 分 


然后 再 点 击 菠萝 的 文字 部 分 ， 由 于 TextView 并 没有 注册 点 击 事件 ， 因 此 
扩 击 文字 这 个 事件 会 个 子 项 的 最 外 层 布 局 捕获 到 ， 效 有 果 如 图 3.38 所 示 。 





图 3.38 
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4 局 作 过 "中 
3.7 编写 界面 的 最 佳 实 践 
既然 已 经 学 习 了 那么 多 UI 开发 的 知识 ， 也 是 时 候 实 战 一 下 了 。 这 次 我 们 
要 综合 运用 前 面 所 学 的 大 量 内 容 来 编写 出 一 个 较为 复杂 且 相 当 美 观 的 聊 
天 界面 ， 你 准备 好 了 吗 ? 要 先 创 建 一 个 UIBestPractice 项 目 才 算 准 备 好 了 
哦 。 
3.7.1 ”制作 Nine-Patch 图 片 
在 实战 正式 开始 之 前 ， 我 们 还 需要 先 学 习 一 下 如 何 制 作 Nine-Patch 图 
片 。 你 可 能 之 前 还 没有 昕 说 过 这 个 名 词 ， 它 是 一 种 被 特殊 处 理 过 的 png 
图 片 ， 能 够 指定 哪些 区 域 可 以 被 拉 伸 、 哪 些 区 域 不 可 以 。 


那么 Nine-Patch 图 片 到 底 有 什么 实际 作用 呢 ? 我 们 还 是 通过 一 个 例子 来 
看 一 下 吧 。 比 如 说 项 目 中 有 一 张 气泡 样式 的 图 片 message_left.png， 如 图 


3.39 所 示 。 
图 3.39 气泡 样式 图 片 


我 们 将 这 张 图 片 设置 为 LinearLayout 的 背景 图 片 ， 修 改 activity_main.xml 








rr 
这 


-hp 
_he ="wrap_content" 
ckground="@drawable/message_left" 


将 LinearLayout 的 宽度 指定 为 match_parent， 然 后 将 它 的 背景 图 设置 
为 message_left， 现 在 运行 程序 ， 效 果 如 图 3.40 所 示 。 
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图 3.40 气泡 被 均匀 拉 伸 的 效果 


可 以 看 到 ， 由 于 message_left 的 宽度 不 足以 填 满 整个 屏幕 的 宽度 ， 整 张 
图 片 被 均匀 地 拉 伸 了 ! 这 种 效果 非常 差 ， 用户 肯定 是 不 能 容忍 的 ， 这 时 
我 们 就 可 以 使 用 Nine-Patch 图 片 来 进行 改善 。 


在 Android sdk 目 录 下 有 一 个 tools 文 件 夹 ， 在 这 个 文件 夹 中 找到 
draw9patch.bat 文 件 ， 我 们 就 是 使 用 它 来 制作 Nine-Patch 图 上 的 。 不 过 ， 
要 打开 这 个 文件 ， 必 须 先 将 JDK 的 bin 目 录 配 置 到 环境 变量 当中 才 行 ， 比 
如 你 使 用 的 是 Android Studio 内 置 的 jdk， 那 么 要 配置 的 路 径 就 是 
<Android ”Studio 安 装 目 录 >/jre/bin。 如 果 你 还 不 知道 该 如 何 配 置 环境 变 
量 ， 可 以 先 去 参考 6.4.1 小 节 的 内 容 。 


双击 打开 draw9patch.bat 文 件 ， 在 导航 栏 点 击 File ~- Open 9-patch 将 
message_left.png 加 载 进 来 ， 如 图 3.41 所 示 。 
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图 3.41 使 用 draw9patch 编 辑 message_left 图 片 


我 们 可 以 在 图 片 的 四 个 边框 绘制 一 个 个 的 小 黑 点 ， 在 上 边框 和 左边 框 绘 

制 的 部 分 表示 当 图 片 需 要 拉 伸 时 就 拉 伸 黑 点 标记 的 区 域 ， 在 下 边框 和 石 

边框 绘制 的 部 分 表示 内 容 会 被 放置 的 区 域 。 使 用 鼠标 在 图 片 的 边缘 拖 动 

2 按 住 Shift 键 拖 动 可 以 进行 擦 除 。 绘 制 完成 后 效果 如 
3.42 有 HT 不 。 
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图 3.42 ”绘制 完成 后 的 message_left 图 片 


最 后 点 击 导航 栏 File Save 9-patch 把 绘制 好 的 图 片 进行 保存 ， 此 时 的 文 
件 名 就 是 message_left.9.png。 使 用 这 张 图 片 蔡 换 掉 之 前 的 
message_left.png 图 片 ， 重 新 运行 程序 ， 效 果 如 网 3.43 所 示 。 
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图 3.43 气泡 只 拉 伸 绘制 区 域 的 效果 


这 样 当 图 片 需 要 拉 伸 的 时 候 ， 残 可 以 只 拉 伸 指定 的 区 域 ， 程 序 在 外 观 上 
也 有 了 很 大 的 改进 。 有 了 这 个 知识 储备 之 后 ， 我 们 就 可 以 进入 实战 环节 
于 5 


3.7.2 ”编写 精美 的 聊天 界面 


既然 是 要 编写 一 个 聊天 界面 ， 那 就 肯定 要 有 收 到 的 消息 和 发 出 的 消息 。 
上 一 节 中 我 们 制作 的 message_left.9.png 可 以 作为 收 到 消息 的 背景 图 ， 那 
么 毫 无 疑问 你 还 需要 再 制作 一 张 message_right.9.png 作 为 发 出 消息 的 背 

景 图 。 


图 片 都 提供 好 了 之 后 就 可 以 开始 编码 了 。 由 于 待 会 我 们 会 用 到 
RecyclerView， 因 此 首先 需要 在 app/build.gradle 当 中 添加 依赖 库 ， 如 下 





所 示 : 


dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 
compile 'com.android.support:appcompat-v7:24.2.1" 
compile 'com.android.support:recyclerview-v7:24.2.1' 
testCompile 'junit:junit:4.12" 


接 下 来 开始 编写 主 界面 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:background="#d8eQe8" > 


<android.support.v7.widget.RecyclerView 
android:id="@+id/msg_recycler_view" 
android:layout_width="match_parent" 
android:layout_height="Qdp" 
android:layout_ weight="1" /> 


<LinearLayout 
android:layout_width="match_parent" 
android:layout_height="wrap_content" > 


<EditText 
android:id="@+id/input_text" 
android:layout_width="Qdp" 
android:layout_height="wrap_content" 
android:layout_ weight="1" 
android:hint="Type something here" 
android:maxLines="2" /> 








<Button 
android:id="@+id/send" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="Send" /> 
</LinearLayout> 


</LinearLayout> 


我 们 在 主 界面 中 放置 了 一 个 RecyclerView 用 于 显示 聊天 的 消息 内 容 ， 又 
放置 了 一 个 EditText 用 于 输入 消息 ， 还 放置 了 一 个 Button 用 于 发 送 消 
0 到 的 所 有 属性 都 是 我 们 之 前 学 过 的 ， 相 信 你 理解 起 来 应 该 不 


然后 定义 消息 的 实体 类 ， 新 建 nsg， 人 代码 如 下 所 未: 


public class Msg { 

public static final int TYPE_RECEIVED = 0; 

public static final int TYPE_SENT = 1; 

private String content; 

private int type; 

public Msg(String content, int type) { 
this.content = content; 
this.type = type; 

} 


public String getContent() { 
return content,; 


public int getType() { 
return type; 
} 


0 4 有 两 个 字段 ，content 表 示 消 息 的 内 容 ，type 表 示 消 息 的 类 
型 。 其 中 消息 类 型 有 两 个 值 可 选 ，TYPE_RECEIVED 表 示 这 是 一 条 收 到 的 
人 一 条 发 出 的 消息 。 


接着 来 编写 RecyclerView 子 项 的 布局 ， 新 建 msg_item.xml， 代 码 如 下 所 
钞 : 








<LinearLayout xmlns: android= sb //schemas.android.com/apk/res/android" 
android:orientation="verti 
android:layout_width= “niatch en 
android:layout_height="wrap_content" 
android:padding="10dp" > 


<LinearLayout 
android:id="@+id/left_layout" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="left" 
android:background="@drawable/message_left" > 


<TextView 
android:id="@+id/left_msg" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center" 
android:layout_margin="10dp" 
android:textColor="#fff" /> 


</LinearLayout> 


<LinearLayout 
android:id="@+id/right. layout" 
android:layout_width= "Wrap content" 
android:layout_height=" ‘wrap_ content" 
android: layout_gravity=" ‘right" 
android:background="@drawable/message_right" 


V 


<TextView 
android:id="@+id/right_msg" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center" 
android:layout_margin="10dp" /> 


</LinearLayout> 


</LinearLayout> 


这 里 我 们 让 收 到 的 消 恩 大 左 对 齐 ， 发 出 的 消 已 居 右 对 齐 ， 并 且 分 别 使 用 
人 left. 9.png 和 message_right.9.png 作 为 背景 图 。 你 可 能 会 有 些 疑 
虑 ， 怎 么 能 让 收 到 的 涧 香 和 发 出 由 注 恩 帮 帮 在 同一 个 布局 里 呢 ? 不 用 担 
心 ， 还 记得 我 们 前 面 学 过 的 可 见 属性 吗 ? 只 要 稍 后 在 代码 中 根据 消息 的 
类 型 来 决定 隐藏 和 显示 哪 种 消息 就 可 以 了 。 


接 下 来 需要 创建 RecyclerView 的 适 配 右 类 ， 新 建 类 MsgAdapter， 代 码 如 
下 所 示 : 





public class MsgAdapter extends RecyclerVview.Adapter<MsgAdapter .ViewHolder> { 
private List<Msg> mMsgList; 
static class ViewHolder extends RecyclerView.ViewHolder { 
LinearLayout leftLayout; 
LinearLayout rightLayout; 
TextView leftMsg; 
TextView rightMsg; 


public ViewHolder (View view) { 
super (view); 
leftLayout = (LinearLayout) view.findViewById(R.id.1left_layout); 
rightLayout = (LinearLayout) view.findViewById(R.id.right_layout); 
leftMsg = (TextView) view.findViewById(R.id.1left_ msg); 
rightMsg = (TextView) view.findViewById(R.id.right_msg); 


} 


public MsgAdapter(List<Msg> msgList) { 
mMsgList = msgList; 
} 


@override 
public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) { 
View view = LayoutInflater.from(parent .getContext()).inflate 
(R.layout.msg_item, parent, false); 
return new ViewHolder (view); 


} 


@override 
public void onBindViewHolder (ViewHolder holder, int position) { 
Msg msg = mMsgList.get(position); 
if (msg.getType() == Msg.TYPE_RECEIVED) { 
// 如 果 是 收 到 的 消息 ， 则 显示 左边 的 消息 布局 ， 将 右边 的 消息 布局 隐藏 
holder .leftLayout .setVisibility(View.VISIBLE) 
holder .rightLayout.setVisibility(View.GONE); 
holder .leftMsg.setText(msg.getContent()); 
} else if(msg.getType() == Msg.TYPE_SENT) { 
// 如 果 是 发 出 的 消息 ， 则 显示 右边 的 消息 布局 ， 将 左边 的 消息 布局 隐藏 
holder.rightLayout .setVisibility(View.VISIBLE) 
holder .leftLayout.setVisibility(View.GONE); 
holder .rightMsg.setText(msg.getContent()); 











} 


@Override 

public int getItemCount() { 
return mMsgList.size(); 

J 


以 上 代码 你 应 该 非常 熟悉 了 ， 和 我 们 学 习 RecyclerView 那 一 节 的 代码 基 
本 是 一 样 的 ， 只 不 过 在 onBindviewHolder() 方 法 中 增加 了 对 消 轧 类 型 的 
判断 。 如 果 这 条 : 消息 是 收 到 的 ， 则 显示 左边 的 消息 布局 ， 如 果 这 条 消息 
是 发 出 的 ， 则 显示 右边 的 消息 布局 。 


最 后 修改 MainActivity 中 的 代码 ， 来 为 RecyclerView 初 始 化 一 些 数据 ， 并 
给 发 送 按钮 加 入 事件 啊 应 ， 代 人 码 如 下 上 所 示 : 


public class MainActivity extends AppCompatActivity { 
private List<Msg> msgList = new ArrayList<>(); 
private EditText inputText; 
private Button send; 
private RecyclerView msgRecyclerView; 
private MsgAdapter adapter; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 


Super .oncCcreate(SavedInstanceState) 
setContentView(R. A ‘activity_i main); 
initMsgs(); // 初始 化 消息 
inputText = (EditText) findViewById(R. id.input_text); 
send = (Button) findViewById(R.id.send); 
msgRecyclerView = (RecyclerView) findViewById(R.id.msg_recycler_view); 
LinearLayoutManager layoutManager = new LinearLayoutManager (this); 
msgRecyclerView.setLayoutManager (layoutManager); 
adapter = new MsgAdapter (msgList); 
msgRecyclerView.setAdapter (adapter); 
send.setonClickListener(new View.OnClickListener() { 
@override 
public void onClick(View v) { 
String content = inputText.getText().tostring(); 
if (!"".equals(content)) 
Msg msg = new Msg(content, Msg.TYPE_SENT); 
msgList.add(msg); 
adapter .notifyItemInserted(msgList.size() - 1); // 当 有 新 消息 时 ， 
刷新 RecyclerView 中 的 显示 
msgRecyclerView. scrollTopPosition(msgList. size() - 1); // 将 
RecyclerView 定 位 到 最 后 - 行 
inputText .setText(""); // 清空 输入 框 中 的 内 容 
} 
} 








}); 
} 


private void initMsgs() { 
Msg msg1 = new Msg("Hello guy.", Msg.TYPE_RECEIVED); 
msgList.add(msg1); 
Msg msg2 = new Msg("Hello. Who is that?", Msg.TYPE_SENT); 
msgList.add(msg2); 
Msg msg3 = new Msg("This is Tom. Nice talking to you. ", Msg.TYPE_RECEIVED); 
msgList.add(msg3); 
} 





在 initMsgs() 方 法 中 我 们 先 初 始 化 了 几 条 数据 用 于 在 RecyclerView 中 显 
示 。 然 后 在 发 送 按钮 的 点 击 事件 里 获取 了 EditText 中 的 内 容 ， 如 果 内 容 
不 为 空 zx 字符 串 则 创建 出 一 个 新 的 Msg 对 象 ， 并 把 它 添加 到 msgList 列 表 中 
Ss 之 后 父 调 用 了 运 配 右 的 notifyItemInserted() 力 法 ， 用 于 通知 列表 
有 新 的 数据 插入 ， 这 样 新 增 的 一 条 消息 才能 够 在 RecyclerView 中 显示 。 
接着 调用 RecyclerView 的 sc rollToPosition() 方 法 将 显示 的 数据 定位 到 
最 后 一 行 ， 以 保证 一 定 可 以 看 得 到 最 后 发 出 的 一 条 消息 。 最 后 调用 
EditText 的 setText() 方 法 将 输入 的 内 容 清 空 


这 样 所 有 的 工作 就 都 完成 了 ， 终 于 可 以 检验 一 下 我 们 的 成 末了 ， 运 行程 
会 看 到 非常 美观 的 聊天 界面 ， 并 且 可 以 输入 和 发 送 消息 ， 如 
3.44 甩 不 。 
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图 3.44 ”精美 的 聊天 界面 
相信 这 个 例子 的 实战 过 程 不 仅 加 深 了 你 对 本 章 中 所 学 UI 知识 的 理解 ， 还 
让 你 有 了 如 何 灵活 运用 这 些 知识 来 设计 出 优秀 界面 的 思路 。 这 一 章 也 是 
学 了 不 少 东西 ， 让 我 们 来 总 结 一 下 吧 。 








3.8 “小结 与 点 评 


虽然 本 章 的 内 容 很 多 ， 但 我 党 得 学 习 起 来 应 该 还 是 挺 愉快 的 吧 。 不 同 于 
上 一 章 中 我 们 来 来 回回 使 用 那 几 个 按钮 ， 本 章 可 以 说 是 使 用 了 各 种 各 样 
的 控件 ， 制 作出 了 丰富 多 彩 的 界面 。 尤 其 是 在 实战 环 市 ， 编 写 出 了 那么 
精美 的 聊天 界面 ， 你 的 满足 感应 该 比 上 一 章 还 要 强 吧 ? 


本 间 从 Android 中 的 一 些 常 见 控 件 开始 入 手 ， 依 次 介绍 了 基本 布局 的 用 
法 、 自 定义 控件 的 方法 、ListView 的 详细 用 法 以 及 RecyclerView 的 使 

用 ， 基 本 已 经 将 重要 的 UI 知识 点 全 部 窗 盖 了 。 想 想 在 开始 的 时 候 我 说 不 
推荐 使 用 可 视 化 的 编辑 工具 ， 而 是 应 该 全 部 使 用 XML 的 方式 来 编写 界 
面 ， 现 在 你 是 不 是 已 经 感觉 使 用 XML 非常 简单 了 呢 ? 以 后 不 管 面 对 多 
么 复杂 的 界面 ， 我 希望 你 都 能 够 自信 满 满 ， 因 为 真正 理解 了 界面 编写 的 
原理 之 后 ， 是 没有 什么 能 够 难得 倒 你 的 。 


不 过 到 目前 为 止 ， 我们 还 只 是 学 习 了 Android 手 机 方面 的 开发 技巧 ， 下 
一 章 将 会 涉及 一 些 Android 平 板 方面 的 知识 点 ， 能 够 同时 兼容 手机 和 平 
板 也 是 自 Android 4.0 系 统 开 始 就 广 持 的 特性 。 适 当地 放松 和 休 居 一 段 时 
间 后 ， 我 们 再 来 继续 前 行 吧 ! 














第 4 章 手机 平板 要 菩 顾 一 一 探 完全 
请 


当今 是 移动 设备 发 展 非常 迅速 的 时 代 ， 不 仅 手 机 已 经 成 为 了 生活 必需 

品 ， 就 连 平 板 电脑 也 变 得 越 来 越 普 及 。 平 板 电脑 和 手机 最 大 的 区 别 惑 在 
于 屏幕 的 大 小 ， 一 般 手 机 屏幕 的 大 小 会 在 3 英才 到 6 英寸 之 间 ， 而 一 般 平 
板 电脑 屏幕 的 大 小 会 在 7 英寸 到 10 英 寸 之 间 。 屏 幕 大 小 差距 过 大 有 可 能 
会 让 同样 的 界面 在 视觉 效果 上 有 和 较 大 的 差异 ， 比 如 一 些 界 面 在 手机 上 看 
起 来 非常 美观 ， 但 在 平板 电脑 上 看 起 来 就 可 能 会 有 控件 被 过 分 拉 长 、 元 
素 之 间 空 了 过 大 等 情况 。 

作为 一 名 专业 的 Android 开 发 人 员 ， 能 够 同时 兼顾 手机 和 平板 的 开发 是 


我 们 必须 做 到 的 事情 。Android 自 3.0 版 本 开始 引入 了 碎片 的 概念 ， 它 可 
以 让 界面 在 平板 上 更 好 地 展示 ， 下 面 我 们 惑 来 一 起 学 习 一 下 。 








4.1 人 页 片 是 什么 


人 肆 片 (Fragment)〉 是 一 种 可 以 艇 入 在 活动 当中 的 UI 片段 ， 它 能 让 程序 更 
加 合理 和 充分 地 利用 大 屏幕 的 空间 ， 因 而 在 平板 上 应 用 得 非常 广泛 。 虽 
然 碎片 对 你 来 说 应 该 是 个 全 新 的 概念 ， 但 我 相信 你 学 习 起 来 应 该 曼 不 我 
力 ， 因 为 它 和 活动 实在 是 太 像 了 了 ， 同 样 都 能 包含 布局 ， 同 样 都 有 目 己 的 
生命 周期 。 你 甚至 可 以 将 雁 片 理解 成 一 个 迷你 型 的 活动 ， 昌 然 这 个 迷你 
型 的 活动 有 可 能 和 普通 的 活动 是 一 样 大 的 。 


那么 究竟 要 如 何 使 用 碎片 才能 充分 地 利用 平板 屏幕 的 空间 呢 ? 想象 我 们 
正在 开发 一 个 新 闻 应 用 ， 其 中 一 个 界面 使 用 RecyclerView 展 示 了 一 组 新 
闻 的 标题 ， 当 点 击 了 其 中 一 个 标题 时 ， 就 打开 另 一 个 界面 显示 新 闻 的 详 
细 内 容 。 如 果 是 在 手机 中 设计 ， 我 们 可 以 将 新 闻 标 题 列 表 放 在 一 个 活动 
中 ， 将 新 闻 的 详细 内 容 放 在 另 一 个 活动 中 ， 如 图 4.1 所 示 。 


























图 4.1 手机 的 设计 方案 
可 是 如 果 在 平板 上 也 这 么 设计 ， 那 么 新 闻 标 题 列 表 将 会 被 拉 长 全 填充 满 





整个 平板 的 屏幕 ， 而 新 闻 的 标题 一 般 都 不 会 太 长 ， 这 样 将 会 导致 界面 上 
有 大 量 的 空白 区 域 ， 如 图 4.2 所 示 。 








图 4.2 平板 的 新 闻 列 表 


因此 ， 更 好 的 设计 方案 是 将 新 闻 标 题 列 表 界 面 和 新 闻 详 细 内 容 界 面 分 别 
放 在 两 个 碎片 中 ， 然 后 在 同一 个 活动 里 引入 这 两 个 碎片 ， 这 样 就 可 以 将 
屏幕 空间 充分 地 利用 起 来 了 ， 如 图 4.3 所 示 。 





图 4.3 平板 的 双 页 设计 


4.2 ”在 厂 的 使 用 方式 


介绍 了 这 么 多 抽象 的 东西 ， 也 是 时 候 学 习 一 下 碎片 的 具体 用 法 了 。 你 已 
经 知道 ， 雁 片 通 闻 都 是 在 平板 开发 中 使 用 的 ， 因 此 我 们 首 移 要 做 的 就 是 
创建 一 个 平板 模拟 占 。 创 建 模拟 费 的 方法 我 们 在 第 1 间 已 经 学 过 了 ， 创 
建 完成 后 启动 平板 模拟 上 器， 效果 如 图 4.4 所 示 。 














图 4.4 平板 模拟 器 的 运行 效果 


好 了 ， 准 备 工 作 都 完成 了 ， 接 着 新 建 一 个 FragmentTest 项 目 ， 然 后 开始 
我 们 的 雄 片 探索 之 旅 吧 。 


4.2.1 雁 片 的 简单 用 法 
这 里 我 们 准备 先 写 一 个 最 简单 的 碎片 示例 来 练 练 手 ， 在 一 个 活动 当中 添 





加 两 个 碎片 ， 并 证 这 两 个 碎 户 平分 活动 空间 。 
新 建 一 个 左 侧 碎片 布局 left_fragment.xml， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<Button 
android:id="@+id/button" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center_horizontal" 
android:text="Button" 
> 


</LinearLayout> 





这 个 布局 非常 简单 ， 只 放置 了 一 个 按钮 ， 并 让 它 水 平 居 中 显示 。 然 后 新 
建 右 侧 碎片 布局 right_fragment.xml， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:background="#00ff00" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<TextView 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center_horizontal" 
android:textSize="20sp" 
android:text="This is right fragment" 
> 


</LinearLayout> 








可 以 看 到 ， 我 们 将 这 个 布局 的 背景 色 设 置 成 了 绿色 ， 并 放置 了 一 个 
TextView 用 于 显示 一 段 文本 。 


接着 新 建 一 个 LeftFragment 类 ， 并 让 它 继 承 目 Fragment。 注意 ， 这 里 可 
能 会 有 两 个 不 同 包 下 的 Fragment 供 你 选择 ， 一 个 是 系统 内 置 的 
android.app.Fragment， 一 个 是 support-v4 库 中 的 
android.support.v4.app.Fragment。 这 里 我 强烈 建议 你 使 用 support-v4 库 中 
的 Fragment， 因 为 它 可 以 让 人 在 片 在 所 有 Android 系 统 版 本 中 保持 功能 一 致 
性 。 比 如 说 在 Fragment 中 嵌 套 使 用 Fragment， 这 个 功能 是 在 Android 4.2 
系统 中 才 开 始 文 持 的 ， 如 果 你 使 用 的 是 系统 内 置 的 Fragment， 那 么 很 遗 
憾 ，4.2 系 统 之 前 的 设备 运行 你 的 程序 就 会 月 让。 而 使 用 Support-v4 库 中 
的 Fragment 就 不 会 出 现 这 个 问题 ， 只 要 你 保证 使 用 的 是 最 新 的 support-v4 
库 就 可 以 了 。 男 外 ， 我 们 并 不 需要 在 build.gradle 文 件 中 添加 support-v4 库 
的 依赖 ， 因 为 build.gradle 文 件 中 已 经 添加 了 appcompat-v7 库 的 依赖 ， 而 
这 个 库 会 将 support-v4 库 也 一 起 引入 进来 。 








现在 编写 一 下 LeftFragment 中 的 代码 ， 如 下 所 示 : 


public class LeftFragment extends Fragment { 


@Ooverride 
public View onCreateView(LayoutInflater inflater, ViewGroup container 
undle SavedInstanceState) 


View view = inflater.inflate(R.]layout.left_ fragment, container, false); 
return view; 
} 





这 里 仅仅 是 重 写 了 Fragment 的 oncreateview() 方 法 ， 然 后 在 这 个 方法 中 
通过 LayoutInflater 的 inflate() 方 法 将 刚才 定义 的 left_fragment 布 局 动态 
加 载 进 来 ， 整 个 方法 简单 明了 。 接 着 我 们 用 同样 的 方法 再 新 建 一 

个 RightFragment， 代 码 如 下 所 示 : 


public class RightFragment extends Fragment { 


@Ooverride 
public View onCreateView(LayoutInflater inflater, ViewGroup container 
Bundle savedInstanceState) 


View view = inflater.inflate(R.layout.right_fragment, container, false); 
return view; 


} 


基本 上 代码 都 是 相同 的 ， 相 信 已 经 没有 必要 再 做 什么 解释 了 。 接 下 来 修 
改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 





<fragment 
android:id="@+id/left_fragment 
android:name="com.example.fragmenttest.LeftFragment" 
android:layout_width="Qdp" 
android:layout_height="match_parent" 
android:layout_ weight="1" /> 


<fragment 
android:id="@+id/right_fragment" 
android:name="com.example.fragmenttest .RightFragment" 
android:layout_width="Qdp" 
android:layout_height="match_parent" 
android:layout weight="1" /> 





</LinearLayout> 


可 以 看 到 ， 我 们 使 用 了 <fragment> 标 签 在 布局 中 添加 碎片 ， 其 中 指定 的 
大 多 数 属性 都 是 你 熟悉 的 ， 只 不 过 这 里 还 需要 通过 android:name 属 性 来 
显 式 指明 要 添加 的 雁 户 类 名 ， 注 意 一 定 要 将 类 的 包 名 也 加 上 。 











这 样 最 简单 的 碎片 示例 束 已 经 写 好 了 ， 现 在 运行 一 下 程序 ， 效 果 如 图 
4.5 所 示 。 
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图 4.5 碎片 的 简单 运行 效果 


正如 我 们 所 期 竺 的 一 样 ， 两 个 雁 片 平分 了 整个 活动 的 布局 。 不 过 这 个 例 
子 实在 是 太 简单 了 ， 在 真正 的 项 目 中 很 难 有 什么 实际 的 作用 ， 因 此 我 们 
马上 来 看 一 看 ， 关 于 碎片 更 加 高 级 的 使 用 技巧 。 


4.2.2 ”动态 添加 碎片 
在 上 一 节 当 中 ， 你 已 经 学 会 了 在 布局 文件 中 添加 酚 片 的 方法 ， 不 过 酚 片 


真正 的 强大 之 处 在 于 ， 它 可 以 在 程序 运行 时 动态 地 添加 到 活动 当中 。 根 























我 们 还 是 在 上 一 节 代 码 的 基础 上 继续 完善 ， 新 建 
another_right_fragment.xml， 代 码 如 下 所 示 : 


<Li rLayout Xm ns De id= http //schel android.com/apk/res/android" 
dr oid:orie "vertica. 
android:bac 二 Ug ni#ffffo0" 


android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<TextView 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center_horizontal" 
android:textSize="20sp" 
android:text="This is another right fragment" 
/3 


</LinearLayout> 


[ay 


这 个 布局 文件 的 代码 和 right_fragment.xml 中 的 代码 基本 相同 ， 只 是 将 让 
景色 改 成 了 黄色 ， 并 将 显示 的 文字 改 了 改 。 然 后 新 建 
AnotherRightFragment 作 为 另 一 个 右 侧 碎片 ， 代 码 如 下 所 示 : 


public class AnotherRightFragment extends Fragment { 


和 


@override 
public View onCreateView(LayoutInflater inflater, ViewGroup container 
Bundle savedInstanceState) { 
View view = inflater.inflate(R.]layout.another_right_fragment, container 
false); 
return view; 


代码 同样 非常 简单 ， 在 oncreateview() 方 法 中 加 载 了 刚刚 创建 的 
another_right_fragment 布 局 。 这 样 我 们 就 准备 好 了 另 一 个 碎片 ， 接 下 来 
看 一 下 如 何 将 它 动 态 地 添加 到 活动 当中 。 修 改 activity_main.xml， 代 码 
如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 





<fragment 
android:id= "@+id/left_ fragment" 
android:name="com.example. en LeftFragment" 
android:layout_width="Qdp" 
android:layout_height="match_parent" 
android:layout_ weight="1" /> 


<FrameLayout 
android:id="@+id/right_layout" 
android:layout_width="Qdp" 
android:layout_height=" pate _parent" 
android:layout_ weight="1" 
</FrameLayout> 





</LinearLayout> 


可 以 看 到 ， 现 在 将 右 侧 碎片 蔡 换 成 了 一 个 FrameLayout 中 ， 还 记得 这 个 
布局 吗 ? 在 上 一 章 中 我 们 学 过 ， 这 是 Android 中 最 简单 的 一 种 布局 ， 所 
有 的 控件 默认 都 会 摆 放 在 布局 的 左上 角 。 由 于 这 里 仅 需 要 在 布局 里 放 入 
一 个 碎片 ， 不 需要 任何 定位 ， 因 此 非常 适合 使 用 FrameLayout。 











下 面 我 们 将 在 代码 中 向 FrameLayout 里 添加 内 容 ， 从 而 实现 动态 添加 碎 
片 的 功能 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceSstate); 
setContentView(R.1layout.activity main); 
Button button = (Button) findViewById(R.id.button); 
button.setonCclickListener(this ) ; 
replaceFragment (new RightFragment()); 


} 


@override 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.button: 
replaceFragment (new AnotherRightFragment()); 
break; 


private void replaceFragment(Fragment fragment) { 
FragmentManager fragmentManager = getSupportFragmentManager(); 
FragmentTransaction transaction = fragmentManager .beginTransaction(); 
transaction.replace(R.id.right_layout, fragment); 
transaction.commit(); 
} 
} 


可 以 看 到 ， 首 先 我 们 给 左 侧 碎 片 中 的 按钮 注册 了 一 个 点 击 事件 ， 然 后 调 
用 replaceFragment() 方 法 动态 添加 了 RightFragment 这 个 碎片 。 当 点 击 
左 侧 雁 片 中 的 按钮 时 ， 又 会 调用 replaceFragment () 方 法 将 右 侧 碎片 蔡 换 
成 AnotherRightFragment。 结 合 replaceFragment() 方 法 中 的 代码 可 以 看 
出 ， 动 态 添 加 碎片 主 要 分 为 5 步 。 


(1) 创建 得 添加 的 碎片 实例 。 


(2) 获取 FragmentManager， 在 活动 中 可 以 直接 通过 调 
用 getsupportFragmentManager() 方 法 得 到 。 


(3) 开启 一 个 事务 ， 通 过 调用 beginTransaction() 方 法 开启 。 


(4) 问 容 器 内 添加 或 蔡 换 人 碎片， 一 般 使 用 replace() 方 法 实现 ， 需 要 传 入 
容器 的 id 和 竺 添加 的 碎片 实例 。 


(5) 提交 事务 ， 调 用 commit() 方 法 来 完成 。 


这 样 束 完 成 了 在 活动 中 动态 添加 雁 片 的 功能 ， 重 新 运行 程序 ， 可 以 看 到 
和 之 前 相同 的 界面 ， 然 后 点 击 一 下 按钮 ， 效 果 如 图 4.6 所 示 。 
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图 4.6 ”动态 添加 碎片 的 效果 


4.2.3 在 雁 片 中 模拟 返回 栈 


在 上 一 小 节 中 ， Nt erie da en Ra) 

尝试 一 下 就 会 发 现 ， 通 过 点 击 按钮 添加 了 一 个 碎片 之 后 ， 这 时 按 下 Back 
键 程序 就 会 家 接 退 出 。 如 果 这 里 我 们 想 模 仿 类 似 于 返回 栈 的 效果 ， 按 下 
Back 键 可 以 回 到 上 一 个 碎片 ， 该 如 何 实现 呢 ? 





其 实 很 简单 ， Wo 了 一 个 addToBackstack() 方 
法 ， 可 以 用 于 将 一 个 事务 添加 到 返回 栈 中 ， 修 改 MainActivity 中 的 代 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 





private void replaceFragment(Fragment fragment) { 
FragmentManager fragmentManager = getSupportFragmentManager(); 
FragmentTransaction transaction = fragmentManager .beginTransaction() ， 
transaction.replace(R.id.right_layout, fragment); 
transaction.addToBackStack(null); 
transaction.commit(); 


这 里 我 们 在 事务 提交 之 前 调用 了 FragmentTransaction 的 
addToBackStack() 方 法 ， 它 可 以 接收 一 个 名 字 用 于 描述 返回 栈 的 状态 

一 般 传 入 null 即 可 。 现 在 重新 运行 程序 ， 并 点 击 按钮 将 
AnotherRightFragment 添 加 到 活动 中 ， 然 后 按 下 Back 键 ， 你 会 发 现 程序 
并 没有 退出 ， 而 是 回 到 了 RightFragment 界 面 ， 继 续 按 下 Back 键 ， 
RightFragment 界 面 也 会 消失 ， 再 次 按 下 Back 键 ， 程 序 才 会 退出 。 


4.2.4 雁 片 和 活动 之 间 进 行 通信 


虽然 雁 片 都 是 嵌入 在 活动 中 显示 的 ， 可 是 实际 上 它们 的 关系 并 没有 那么 
亲密 。 你 可 以 看 出 ， 雁 片 和 活动 都 是 各 目 存 在 于 一 个 独立 的 类 当中 的 ， 
它们 之 间 并 没有 那么 明显 的 方式 来 直接 进行 通信 。 如 有 果 想 要 在 活动 中 调 
用 碎片 里 的 方法 ， 或 者 在 雁 片 中 调用 活动 里 的 方法 ， 应 该 如 何 实现 呢 ? 


为 了 方便 碎片 和 活动 之 间 进 行 通 信 ，FragmentManager 提 供 了 一 个 类 似 
专门 用 于 从 布局 文件 中 获取 雄 片 的 实例 ， 代 
人 码 如 下 所 示 : 


RightFragment a Fr nt = (R oer enon) getSupportFragmentManager() 
.findFragme fyrd (Re id、 right_fragment); 























调用 FragmentManager 的 findFragmentById() 方 法 ， 可 以 在 活动 中 得 到 相 
应 人 碎片 的 实例 ， 然 后 就 能 轻松 地 调用 碎片 里 的 方法 了 。 


掌握 了 如 何在 活动 中 调用 碎片 里 的 方法 ， 那 在 碎片 中 义 该 怎样 调用 活动 
里 的 方法 呢 ? 其 实 这 就 更 简单 了 ， 在 每 个 碎片 中 都 可 以 通过 调 
getActivity() 方 法 来 得 到 和 当前 雁 方 相关 联 的 活动 实例 ， 代 码 如 下 

人 外: 


MainActivity activity = (MainActivity) getActivity() 








有 了 活动 实例 之 后 ， 在 碎片 中 调用 活动 里 的 方法 就 变 得 轻而易举 了 。 男 
外 当 碎 片 中 需要 使 用 context 对 象 时 ， 也 可 以 使 用 getActivity() 方 法 ， 
因为 获取 到 的 活动 本 身 束 是 一 个 context 对 象 。 





这 时 不 知道 你 心中 会 不 会 产生 一 个 疑问 : 既然 碎片 和 活动 之 间 的 通信 和 问 
题 已 经 解决 了 ， 那 么 雄 片 和 雄 片 之 间 可 不 可 以 进行 通信 呢 ? 


说 实在 的 ， 这 个 问题 并 没有 看 上 去 那么 复杂 ， 它 的 基本 思路 非常 简单 ， 
首先 在 一 个 碎片 中 可 以 得 到 与 它 相关 联 的 活动 ， 然 后 再 通过 这 个 活动 去 
获取 另外 一 个 碎片 的 实例 ， 这 样 也 就 实现 了 不 同人 碎 卢 之 间 的 通信 功能 ， 
因此 这 里 我 们 的 答案 是 肯定 的 。 





4.3” 砍 片 的 生命 周期 


和 活动 一 样 ， 雁 片 也 有 上 自己 的 生命 周期 ， 并 且 它 和 活动 的 生命 周期 实在 
是 太 像 了 ， 我 相信 你 很 快 就 能 学 会 ， 下 面 我 们 与 上 就 来 看 一 下 。 


4.3.1 人 雄 片 的 状态 和 回调 


还 记得 每 个 活动 在 其 生命 周期 内 可 能 会 有 哪 几 种 状态 吗 ? 没 错 ， 一 共有 
运行 状态 、 暂 停 状态 、 停 止 状态 和 销毁 状态 这 4 种 。 类 似 地 ， 每 个 碎片 
在 其 生命 周期 内 也 可 能 会 经 历 这 几 种 状态 ， 只 不 过 在 一 些 细小 的 地 方 会 
有 部 分 区 别 。 


1. 运行 状态 


当 一 个 碎片 是 可 见 的 ， 并 且 它 所 关联 的 活动 正 处 于 运行 状态 时 ， 该 
碎片 也 处 于 运行 状态 。 

2. 暂停 状态 
当 一 个 活动 进入 暂停 状态 时 《由 于 另 一 个 未 占 满 屏 幕 的 活动 被 添加 
到 了 栈 顶 ) ， 与 它 相 关联 的 可 见 雁 片 怠 会 进入 到 暂停 状态 。 

3. 停止 状态 
当 一 个 活动 进入 停止 状态 时 ， 与 它 相 关联 的 碎片 就 会 进入 到 停止 状 
态 ， 或 者 通过 调用 FragmentTransaction 的 remove()、replace() 方 法 
将 雁 瞩 从 活动 中 移 除 ， 但 如 果 在 事务 提交 之 前 调 
用 addToBackSstack() 方 法 ， 这 时 的 雄 片 也 会 进入 到 停止 状态 。 忌 的 
来 说 ， 进 入 停止 状态 的 碎片 对 用 户 来 说 是 完全 不 可 见 的 ， 有 可 能 会 
被 系统 回收 。 

4. 销毁 状态 


雁 片 总 是 依附 于 活动 而 存在 的 ， 因 此 当 活 动 被 销毁 时 ， 与 它 相 关联 
的 碎 瞩 了 驶 会 进入 到 销毁 状态 。 或 者 通过 调用 FragmentTransaction 的 

















remove()、replace() 方 法 将 碎片 从 活动 中 移 除 ， 但 在 事务 提交 之 前 
并 没有 调用 addToBackstack( ) 方 法 ， 这 时 的 碎片 也 会 进入 到 销毁 状 





结合 之 前 的 活动 状态 ， 相 信 你 理解 起 来 应 该 对 不 费力 吧 。 同 样 
地 ，Fragment 类 中 也 提供 了 一 系列 的 回调 方法 ， 以 覆盖 碎片 生命 周期 的 
每 个 环节 。 其 中 ， 活 动 中 有 的 回调 方法 ， 碎 片 中 几乎 都 有 ， 不 过 碎片 还 
提供 了 一 些 附加 的 回调 方法 ， 那 我 们 就 重点 看 一 下 这 儿 个 回调 。 








。 onAttach()。 当 碎片 和 活动 建立 关联 的 时 候 调 用 。 
onCreateview()。 为 碎片 创建 视图 〈 加 载 布 局 ) 时 调用 。 


onActivitycreated()。 确 保 与 雁 片 相关 联 的 活动 一 定 已 经 创建 完毕 
的 时 候 调 用 。 


onDestroyView( ) 。 当 与 雄 片 关联 的 视图 被 移 除 的 时 候 调 用 。 
onDetach( )。 当 碎片 和 活动 解除 关联 的 时 候 调 用 。 
人 碎片 完整 的 生命 周期 示意 图 可 参考 图 4.7， 图 片 源 自 Android 官 网 。 
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图 4.7 碎片 的 生命 周期 
4.3.2 ”体验 碎片 的 生命 周期 


为 了 让 你 能 够 更 加 直观 地 体验 雁 片 的 生命 周期 ， 我 们 还 是 通过 一 个 例子 
来 实践 一 下 。 例 子 很 简单 ， 仍 然 古 在 FragmentTest 项 目的 基础 上 改动 
的 。 


修改 RightFragment 中 的 代码 ， 如 下 所 示 : 


public class RightFragment extends Fragment { 
public static final String TAG = "RightFragment"; 


@override 

public void onAttach(Context context) { 
super .onAttach(context ) ; 
Log.d(TAG, "onAttach"); 


@Override 

public void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedIinstanceState); 
Log.d(TAG, "onCreate"); 


@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container 
Bundle savedInstanceState) { 
Log.d(TAG, "onCreateView"); 
View view = inflater.inflate(R.layout.right_fragment, container, false); 
return view; 


} 


@override 

public void onActivityCreated(Bundle savedInstanceState) { 
super .onActivityCreated(savedInstanceState); 
Log.d(TAG, "onActivityCreated"); 


@override 

public void onStart() { 
super .onstart(); 
Log.d(TAG, "onStart") ; 

} 


@Ooverride 

public void onResume() { 
super .onResume( ); 
Log.d(TAG, "onResume"); 


@Override 

public void onPause() { 
super .onPpause(); 
Log.d(TAG, "onPause"); 


@Override 

public void onStop() { 
super .onstop(); 
Log.d(TAG, "onSstop"); 


@override 

public void onDestroyView() { 
super .onDestroyView(); 
Log.d(TAG, "onDestroyView"); 


@override 

public void onDestroy() { 
super .onDestroy(); 
Log.d(TAG, "onDestroy"); 

} 


@Override 
public void onDetach() { 
super .onDetach( ); 


Log.d(TAG, "onDetach"); 


我 们 在 RightFragment 中 的 每 一 个 回调 方法 里 都 加 入 了 打印 日 志 的 代码 ， 
然后 重新 运行 程序 ， 这 时 观察 logcat 中 的 打印 信息 ， 如 图 4.8 所 示 。 


ee 上 AN 
| Verbose 局 IQrRightFragment | 


com. example. fragmenttest D/RightFragment: onAttach 











com. example. fragmenttest D/RightFragment: onCreate 

com. example. fragmenttest D/RightFragment: onCreateView 

com. example. fragmenttest D/RightFragment: onActivityCreated 
com. example. fragmenttest D/RightFragment: onStart 


com. example. fragmenttest D/RightFragment: onResume 


图 4.8 局 动 程序 时 的 打印 日 志 
可 以 看 到 ， 当 RightFragment 第 一 次 被 加 载 到 屏幕 上 时 ， 会 依次 执 


行 onAttach()、 onCreate()、 onCreateView()、 onActivityCreated()、or 
和 onResume() 方 法 。 然后 点 击 LeftFragment 中 的 按钮 ， 此 时 打印 信息 如 
图 4.9 所 示 。 








二 
Verbose 加 (Q- RightFragment ) 





com. example. fragmenttest D/RightFragment: onPause 
com. example. fragmenttest D/RightFragment: onStop 


com. example. fragmenttest D/RightFragment: onDestroyView 


图 4.9 ” 蔡 换 成 AnotherRightFragment 时 的 打印 日 志 


由 于 AnotherRightFragment 蔡 换 了 RightFragment， 此 时 的 RightFragment 
进入 了 停止 状态 ， 因 此 onPause()、onstop() 和 onDestroyview() 方 法 会 
得 到 执行 。 当 然 如 果 在 蔡 换 的 时 候 没 有 调用 addToBackstack() 方 法 ， 此 
时 的 RightFragment 就 会 进入 销毁 状态 ，onpDestroy() 和 onpDetach() 方 法 束 
会 得 到 执行 。 


接着 按 下 Back 键 ，RightFragment 会 重新 回 到 屏幕 ， 打 印信 息 如 图 4.10 所 
未 





| Verbose 图 (Q. RightFragment ) 


com. example. fragmenttest D/RightFragment: onCreateView 





com. example. fraementtest D/RightFraement: onActivityCreated 
com. example. fragmenttest D/RightFragment: onStart 


com. example. fragmenttest D/RightFragment: onResume 


图 4.10 返回 RightFragment 时 的 打印 日 志 
由 于 RightFragment 重 新 回 到 了 运行 状态 ， 
此 oncreatevView()、onActivitycreated()、onstart() 和 onResume() 方 法 
会 得 到 执行 。 注 意 此 时 oncreate() 方 法 并 不 会 执行 ， 因 为 我 们 借助 了 
addToBackSstack() 方 法 使 得 RightFragment 并 没有 被 销毁 。 
现在 再 次 按 下 Back 键 ， 打 印信 息 如 图 4.11 所 示 。 
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com. example. fragmenttest D/RightFragment: onPause 











com. example. fragmenttest D/RightFragment: onStop 

com. example. fragmenttest D/RightFragment: onDestroyView 
com. example. fragmenttest D/RightFragment: onDestroy 
com. example. fragmenttest D/RightFragment: onDetach 


图 4.11 退出 程序 时 的 打印 日 志 


依次 会 a onstop()、onDestroyView()、onDestroy() 和 和 
onDetach() 方 法 ， 最 终 将 雁 上 销毁 挥 。 这 样 碎片 完整 的 生命 周期 你 也 体 
验 了 一 遍 ， 是 不 是 理解 得 更 加 深刻 了 ? 


另外 值得 一 提 的 是 ， 在 雁 放 中 你 也 是 可 以 通过 onsaveInstanceState() 方 
法 来 保存 数据 的 ， 因 为 进入 停止 状态 的 碎 请 有 可 能 在 系统 内 存 不 足 的 时 
候 被 回收 。 保存 下 来 的 数据 在 oncreate()、 onCreateView( ) 和 和 
onActivitycreated() 这 3 个 方法 中 你 都 可 以 重新 得 到 ， 它 们 都 含有 一 个 











Bundle 类 型 的 savedInstanceSstate 人 参数 。 上 有 具体 的 代码 我 就 不 在 这 里 给 出 
了 ， 如 果 你 筷 记 了 该 如 何 编号， 可 以 参考 2.4.5 小 节 。 





4.4 ”动态 加 载 布局 的 技巧 


虽然 动态 添加 碎片 的 功能 很 强大 ， 可 以 解决 很 多 实际 开发 中 的 问题 ， 但 
是 它 毕竟 只 是 在 一 个 布局 文件 中 进行 一 些 添加 和 蔡 换 操 作 。 如 果 程 序 能 
够 根据 设备 的 分 辩 率 或 屏幕 大 小 在 运行 时 来 决定 加 载 哪个 布局 ， 那 我 们 
可 发 挥 的 空间 束 更 多 了 。 因 此 本 节 我 们 就 来 探讨 一 下 Android 中 动态 加 
载 布 局 的 技巧 。 


4.4.1 使 用 限定 符 


如 果 你 经 常 使 用 平板 电脑 ， 应 该 会 发 现 现在 很 多 的 平板 应 用 都 采用 的 是 
双 页 模式 (程序 会 在 左 侧 的 面板 上 显示 一 个 包含 子 项 的 列表 ， 在 右 侧 的 
面板 上 显示 内 容 ) ， 因 为 平板 电脑 的 屏幕 足够 大 ， 完 全 可 以 同时 显示 下 
两 页 的 内 容 ， 但 手机 的 屏幕 一 次 就 只 能 显示 一 页 的 内 容 ， 因 此 两 个 页 面 
需要 分 开 显示 。 

那么 怎样 才能 在 运行 时 判断 程序 应 该 是 使 用 双 页 模式 还 是 单 页 模式 呢 ? 
这 就 需要 借助 限定 符 〈Qualifiers》 来 实现 了 。 下 面 我 们 通过 一 个 例子 来 


学 习 一 下 它 的 用 法 ， 修 改 FragmentTest 项 目 中 的 activity_main.xml 文 件 ， 
代码 如 下 所 示 : 


<LinearLa ayou Xm nin anar oi oe ep //schemas.android.com/apk/res/android" 
andro i "ho al" 














nta ati 
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这 里 将 多 余 的 代码 都 删 掉 ， 只 留 下 一 个 左 侧 雁 片 ， 并 让 它 充 满 整 个 父 布 
局 。 接 着 在 res 目 录 下 新 建 layout-large 文 件 夹 ， 在 这 个 文件 夹 下 新 建 一 个 
布局 ， 也 叫 作 activity_main.xml， 人 代码 如 下 所 示 ; 





andr oi id= "http: //s chemas.android.com/apk/res/android" 


ns 
六 tati 
ut_wi idth= matc h rd 
ut_hei nea match_parent" 


id: a "@+ 人 做 _fragm 
roid: me= ample a He nttest.LeftFragment" 
id: 1ayo0 ut 和 "QOdp" 


android:layout_height="match_parent" 
android:layout weight="1" /> 


<fragment 
android:id= "@tid/right. fragment" 
android:name="com. example. fragmenttest.RightFragment" 
android:layout_width="Qdp" 
android:layout_height="match_parent" 
android:layout_ weight="3" /> 


</LinearLayout> 





可 以 看 到 ，layoutactivity_main 布 局 只 包含 了 一 个 碎片 ， 即 单 页 模式 ， 

而 layout-large/ ”activity_main 布 局 包含 了 两 个 雄 片 ， 即 双 页 模式 。 其 中 
large 了 台 是 一 个 限定 符 ， 那 些 屏 幕 被 认为 是 large 的 设备 融会 自动 加 载 
2 的 布局 ， 而 小 屏 磊 的 设备 则 还 是 会 加 载 layout 文 件 

光 下 的 布局 。 


然后 将 MainActivity 中 replaceFragment() 方 法 里 的 代码 注释 掉 ， 并 在 平 
板 模拟 右上 重新 运行 程序 ， 效 果 如 图 4.12 所 示 。 








FragmentTest 


BUTTON 








图 4.12 双 页 模式 运行 效果 


再 启动 一 个 手机 模拟 器 ， 并 在 这 个 模拟 右上 重新 运行 程序 ， 效 果 如 图 
4.13 所 示 。 


FragmentTest 








图 4.13 单 页 模式 运行 效果 
这 样 我 们 束 实 现 了 在 程序 运行 时 动态 加 载 布 局 的 功能 。 
Android 中 一 些 党 见 的 限定 符 可 以 参考 下 表 。 
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供给 中 等 
[= 他 资 人 

属 | ldpi -一 (120dpi 以 下 ) 






提供 多 高 分 关 全 和风 ( aD 
i 提供 给 超 超 高 分 状 率 设备 的 资源 (320dpi~480dpi) 


是 供给 横 屏 设备 的 资源 


提供 给 竖 屏 设备 的 资源 








4.4.2 使 用 最 小 宽度 限定 符 


在 上 一 小 节 中 我 们 使 用 1arge 限 定 符 成 功 解决 了 单 页 双 页 的 判断 问题 ， 
不 过 很 快 勾 有 一 个 新 的 问题 出 现 了 ，1large 到 底 是 指 多 大 呢 ? 有 的 时 候 
我 们 希望 可 以 更 加 器 活 地 为 不 同 设备 加 载 布局 ， 个 管 它 们 是 个 是 被 系统 


认定 为 large， 这 时 就 可 以 使 用 最 小 宽度 限定 符 〈(Smallest-width 
Qualifier) 了 。 














最 小 宽度 限定 符 多 许 我 们 对 屏幕 的 宽度 指定 一 个 最 小 值 〈 以 dp 为 单 
位 ) ， 然 后 以 这 个 最 小 值 为 临界 点 ， 屏幕 宽度 大 于 这 个 值 的 设备 就 加 载 
一 个 布局 ， 屏 幕 宽度 小 于 这 个 值 的 设备 就 加 载 另 一 个 布局 。 




















在 res 目 录 下 新 建 layout-sw600dp 文 件 夹 ， 然 后 在 这 个 文件 夹 下 新 建 
activity_main.xml 布 局 ， 代 人 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<fragment 
android:id= "@tid/left. fragment" 
android:name="com.example. ee LeftFragment" 
android:layout_width="Qdp" 
android:layout_height="match_parent" 
android:layout_ weight="1" /> 


<fragment 
android:id="@+id/right_fragment" 
android:name="com.example.fragmenttest .RightFragment" 
android:layout_width="Qdp" 
android:layout_height="match_parent" 
android:layout weight="3" /> 





</LinearLayout> 








这 就 意味 着 ， 当 程 厅 运 行 在 屏 笑 宽度 大 于 600dp 的 设备 上 时 ， 会 加 载 
layout-sw600dp/activity_main 布 局 ， 当 程序 运行 在 屏幕 宽度 小 于 600dp 的 
设备 上 时 ， 则 仍然 加 载 默认 的 layoutactivity_main 布 局 。 











4.5 ”人 雄 厂 的 最 佳 实践 一 一 一 个 简易 版 
的 新 闻 应 用 


现在 你 已 经 将 关于 雁 片 的 重要 知识 点 都 掌握 得 兰 不 多 了 ， 不 过 在 灵活 运 
用 方面 可 能 还 有 些 人 欠缺， 因此 下 面 该 进入 我 们 本 章 的 最 佳 实践 环节 了 。 


前 面 有 提 到 过 ， 碎 厂 很 多 时 候 部 是 在 平板 开发 当中 使 用 的 ， 主 要 是 为 了 
解决 屏 副 空间 不 能 充分 利用 的 问题 。 那 是 不 是 束 表 明 ， 我 们 开 友 的 程序 
都 需要 提供 一 个 手机 版 和 一 个 Pad 版 呢 ?” 确 实 有 不 少 公司 都 是 这 么 做 
的 ， 但 是 这 样 会 浪费 很 多 的 人 力 物 力 。 因 为 维护 两 个 版 本 的 代码 成 本 很 
高 ， 每 当 增加 什么 新 功能 时 ， 需 要 在 两 份 代 码 里 各 写 一 过 ， 每 当 发 现 一 
个 bug 时 ， 需 要 在 两 份 代码 里 各 修改 一 次 。 因 此 今天 我 们 最 佳 实践 的 内 
容 就 是 ， 教 你 如 何 编 写 同时 兼容 手机 和 平板 的 应 用 程序 。 


还 记得 在 本 章 开始 的 时 候 提 到 过 的 一 个 新 闻 应 用 吗 ? 现在 我 们 就 将 运用 
本 章 中 所 学 的 知识 来 编写 一 个 简易 版 的 新 闻 应 用 ， 并 且 要 求 它 是 可 以 同 
时 兼容 手机 和 平板 的 。 新 建 好 一 个 FragmentBestPractice 项 目 ， 然 后 开始 
动手 吧 ! 


由 于 竺 会 在 编写 新 闻 列 表 时 会 使 用 到 RecyclerView， 因 此 首先 需要 在 
app/build.gradle 当 中 添加 依赖 库 ， 如 下 所 示 : 


dependencies { 

















-Iibs' dneLludes [1ar"]y 
compile 'com.android.support:appcompat-v7:24.2.1" 
testCompile 'junit:junit:4.12' 
compile 'com.android.support:recyclerview-v7:24.2.1' 
} 


接 下 来 我 们 要 准备 好 一 个 新 闻 的 实体 类 ， 新 建 类 News， 代 人 码 如 下 所 示 : 


public class News { 

private String title; 

private String content; 

public String getTitle() { 

return title; 

} 

public void setTitle(String title) { 
title; 


this.title = 


public String getContent() { 
return content,; 


} 


public void setContent(String content) { 
this.content = content; 
} 








News 类 的 代码 还 是 比较 简单 的 ，title 字 段 表示 新 闻 标 题 ，content 字 段 
表示 新 闻 内 容 。 接 着 新 建 布局 文件 news_content_frag.xml， 用 于 作为 新 
闻 内 容 的 布局 : 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 





<LinearLayout 
android:id="@+id/visibility_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:orientation="vertical" 
android:visibility="invisible" > 


<TextView 
android:id="@+id/news_title" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:gravity="center" 
android:padding="10dp" 
android:textSize="20sp" /> 


<View 
android:layout_ width="match_parent" 
android:layout_height="1dp" 
android:background="#000" /> 


<TextView 
android:id="@+id/news_content" 
android:layout_width="match_parent" 
android:layout_height="Qdp" 
android:layout_ weight="1" 
android:padding="15dp" 
android:textSize="18sp" /> 
</LinearLayout> 
<View 
android:layout_width="1idp" 
android:layout_height="match_parent" 
android:layout_alignParentLeft="true" 
android:background="#000" /> 


</RelativeLayout> 


新 闻 内 容 的 布局 主要 可 以 分 为 两 个 部 分 ， 头 部 部 分 显示 新 闻 标 题 ， 正 文 
部 分 显示 新 闻 内 容 ， 中 间 使 用 一 条 细 线 分 隔 开 。 这 里 的 细 线 是 利用 View 
来 实现 的 ， 将 View 的 宽 或 高 设置 为 dp， 再 通过 background 属 性 给 细 线 
设置 一 下 颜色 就 可 以 了 。 这 里 我 们 把 细 线 设置 成 黑色 。 


然后 再 新 建 一 个 NewscontentFragment 类 ， 继承 自 Fragment, 代码 如 下 所 


修 \: 


public class NewsContentFragment extends Fragment { 
private View view; 
@override 


public View onCreateView(LayoutInflater inflater, ViewGroup container 
Bundle savedInstanceState) { 


view = inflater.inflate(R.1layout.news_content_frag, container, false); 
return view; 

} 

public void refresh(String newsTitle, String newsContent) 
View visibilityLayout = view.findViewById(R.id.visibility_layout); 
visibilityLayout.setVisibility(View.VISIBLE); 
TextView newsTitleText = (TextView) view.findViewById (R.id.news_ title); 
TextView newsContentText = (TextView) view.findViewById(R.id.news_content); 
newsTitleText.setText(newsTitle); // 刷新 新 闻 的 标题 
newsContentText .setText(newsContent ); // 刷新 新 闻 的 内 容 

J 


首先 在 oncreateview( ) 方 法 里 加 载 了 我 们 刚刚 创建 的 news_content_frag 
布局 ， 这 个 没什么 好 解释 的 。 接 下 来 又 提供 了 一 个 refresh() 方 法 ， 这 
个 方法 就 是 用 于 将 新 闻 的 标题 和 内 容 显示 在 界面 上 的 。 可 以 看 到 ， 这 里 
通过 findviewById() 方 法 分 别 获 取 到 新 闻 标 题 和 内 容 的 控件 ， 然 后 将 方 
法 传递 进来 的 参数 设置 进去 。 


这 样 我 们 就 把 新 闻 内 容 的 碎 上 请 和 布局 都 创建 好 了 ， 但 是 它们 都 是 在 双 页 
模式 中 使 用 的 ， 如 果 想 在 单 页 模式 中 使 用 的 话 ， 我 们 还 需要 再 创建 一 个 
活动 。 右 击 com.example.fragmentbestpractice 包 New Activity Empty 
Activity， 新 人 并 将 布局 名 指定 成 
news_content， 然 后 修改 news_content.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 











<fragment 
android:id="@+id/news_content_fragment" 
android:name="com.example.fragmentbestpractice.NewsContentFragment" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
/> 


</LinearLayout> 








这 里 我 们 充分 发 挥 了 代码 的 复 用 性 ， 直 接 在 布局 中 引入 了 
NewsContentFragment, 这 样 也 就 相当 于 把 news_content_frag 布 局 的 内 容 
目 动 加 了 进来 。 


然后 修改 NewscontentActivity 中 的 代码 ， 如 下 所 示 : 


public class NewsContentActivity extends AppCompatActivity { 





public static void actionStart(Context context, String newsTitle, String 
newsContent) { 
Intent intent = new Intent(context, NewsContentActivity.class); 
intent. putExtra(" news_title", newsTitle); 
intent.putExtra( "news Jcontent" newsContent ); 
context. startActivity(intent);” 


} 


@override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedIinstanceState); 


setContentView(R.1layout.news_content); 

String newsTitle = getIntent().getStringExtra("news_title"); // 获取 传 入 的 新 

闻 标题 

SECing newsContent = getIntent().getStringExtra("news_content"); // 获取 传 入 

的 新 闻 内 容 

NewsContentFragment newsContentFragment = (NewsContentFragment) 

getSupportFragmentManager().findFragmentById(R.id.news_content_fragment); 

newsContentFragment.refresh(newsTitle, newsContent); // 刷 新 NewsContent - 
Fragment 界 面 


可 以 看 到 ， 在 oncreate() 方 法 中 我 们 通过 Intent 获 取 到 了 传 入 的 新 闻 标 题 
和 新 闻 内 容 ， 然 后 调用 FragmentManager 的 findFragmentById() 方 法 得 到 
了 NewscontentFragment 的 实例 ， 接 着 调用 它 的 refresh() 方 法 ， 并 将 新 

半 的 标题 和 内 容 传 入 ， 就 可 以 把 这 些 数据 显示 出 来 了 。 注 意 这 里 我 们 还 
提供 了 一 还 记得 它 的 作用 吗 ? 如 果 忘 记 的 话 束 

再 去 阅读 一 人 裔 2.6.3 小 节 吧 。 


接 下 来 还 需要 再 创建 一 个 用 于 显示 新 闻 列 表 的 布局 ， 新 建 
news_title_frag.xml， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 








<android. support. V7 .widget.RecyclerView 
android:id="@+id/news_title recycler_ View" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
/> 


</LinearLayout> 





这 个 布局 的 代码 就 非常 简单 了 ， 里 面 只 有 一 个 用 于 显示 新 闻 列 表 的 
RecyclerView。 既 然 要 用 到 RecyclerView， 那 么 就 必定 少不了 子 项 的 布 
局 。 新 建 news_item.xml 作 为 RecyclerView 子 项 的 布局 ， 代 码 如 下 所 示 : 


<TextView xmlns:android="http : //schemas. android.com/apk/res/android" 
android:id="@+id/news_title 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:maxLines="true" 
android:ellipsize="end" 
android:textSize="18sp" 
android:paddingLeft="10dp" 
android:paddingRight="10dp" 
android:paddingTop="15dp" 
android:paddingBottom="15dp" /> 





子 项 的 布局 也 非常 人 简单， 只 有 一 个 TextView。 仔 细 观 察 TextView， 你 会 
发 现 其 中 有 几 个 属 性 是 我 们 之 前 没有 学 过 的 。 android:padding 表 示 给 控 
件 的 周围 加 上 补 白 ， 这 样 不 至 于 让 文本 内 容 会 紧 靠 在 边缘 


上 。android:maxLines 设 置 为 true 表 示 让 这 个 TextView 只 能 单行 显 
示 。 android:ellipsize 用 于 设 定 当 文 本 内 容 超出 控件 宽度 时 ， 文本 的 缩 
略 方式 ， 这 里 指定 成 end 表 示 在 尾部 进行 缩 略 。 


既然 新 闻 列 表 和 子 项 的 布局 都 已 经 创建 好 了 ， 那 么 接 下 来 我 们 就 需要 一 
个 用 于 展示 新 闻 列 表 的 地 方 。 这 里 新 建 NewsTitleFragment 作 为 展示 新 闻 
列表 的 雄 片 ， 代 码 如 下 所 示 : 


public class NewsTitleFragment extends Fragment { 





private boolean isTwoPane; 


@override 
public View onCreateView(LayoutIinflater inflater, ViewGroup container, 
Bundle savedInstancestate) 下 

View view = inflater. stele layout.news_title frag, container, false); 
return view; 

. 

@Override 

public void onActivityCreated(Bundle savedInstanceState) { 
super .onActivityCreated(savedInstanceState); 
并 (getActivity(). findViewById(R.id.news_content_layout) != null) { 

isTwoPane = true; // 可 以 找到 news_content_layout 布 局 时 ， 为 双 页 模式 

} else { 

isTwoPane = false; // 找 不 到 news_content_layout 布 局 时 ， 为 单 页 模式 


可 以 看 到 ，NewsTitleFragment 中 并 没有 多 少 代码 ， 在 oncreateView() 方 
法 中 加 载 了 news_title_frag 布 局 ， 这 个 没什么 好 说 的 。 我 们 注意 看 一 

下 onActivitycreated() 方 法 ， 这 个 方法 通过 在 活动 中 能 人 否 找到 一 个 id 为 
news_content_layout 的 View 来 判断 当前 是 双 页 模式 还 是 单 页 模式 ， 因 此 
我 们 需要 让 这 个 id 为 news_content_layout 的 View 只 在 双 页 模式 中 才 会 出 
现 。 


那么 怎样 才能 实现 这 个 功能 呢 ? 其 实 并 不 复杂 ， 只 需要 借助 我 们 刚刚 学 
过 的 限定 符 就 可 以 了 。 首先 修改 activity main.xml 中 的 代码 ， 如 下 所 
示 : 


<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/news_title_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<fragment 
android:id="@+id/news_title_fragment" 
android:name="com.example.fragmentbestpractice.NewsTitleFragment" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
/> 


</FrameLayout> 


上 述 代码 表示 ， 在 蛙 页 模式 下 ， 只 会 加 载 一 个 新 闻 标题 的 雄 片 。 





然后 新 建 layout-sw600dp 文 件 夹 ， 在 这 个 文件 夹 下 再 新 建 一 个 
activity_main.xml 文 件 ， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<fragment 
android:id="@+id/news_title_fragment" 
android:name="com.example.fragmentbestpractice.NewsTitleFragment" 
android:layout_width="Qdp" 
android:layout_height="match_parent" 
android:layout_ weight="1" /> 


<FrameLayout 
android:id="@+id/news_content_layout" 
android:layout_width="Qdp" 
android:layout_height="match_parent" 
android:layout_ weight="3" > 


<fragment 
android:id="@+id/news_content_fragment" 
android:name="com.example.fragmentbestpractice.NewsContentFragment" 
android:layout_width="match_parent" 
android:layout_height="match_parent" /> 
</FrameLayout> 


</LinearLayout> 





可 以 看 出 ， 在 双 页 模式 下 我 们 同时 引入 了 两 个 碎片 ， 并 将 新 闻 内 容 的 碎 
片 放 在 了 一 个 FrameLayout 布 局 下 ， 而 这 个 布局 的 id 正 是 
newSs_content_layout。 因 此 ， 能 够 找到 这 个 id 的 时 候 就 是 双 页 模式 ， 合 
则 就 是 单 面 模式 。 


现在 我 们 已 经 将 绝 大 部 分 的 工作 都 完成 了 ， 但 还 剩 下 至 关 重 要 的 一 点 ， 
就 是 在 NewsTitleFragment 中 通过 RecyclerView 将 新 闻 列 表 展 示 出 来 。 我 
们 在 NewsTitleFragment 中 新 建 一 个 内 部 类 NewsAdapter 来 作为 
RecyclerView 的 适配器 ， 如 下 所 示 : 


public class NewsTitleFragment extends Fragment { 


private boolean isTwoPane; 


class NewsAdapter extends RecyclerView.Adapter<NewsAdapter.ViewHolder> { 
private List<News> mNewsList; 
class ViewHolder extends RecyclerView.ViewHolder { 
TextView newsTitleText; 


public ViewHolder(View view) { 
super (view); 
newsTitleText = (TextView) view.findViewById(R.id.news_ title); 


} 


public NewsAdapter(List<News> newsList) { 
mNewsList = newsList,; 


@override 
public ViewHolder onCreateViewHolder (ViewGroup parent, int viewType) { 
View view = LayoutInflater.from(parent .getContext()) 
.inflate(R.layout.news_item, parent, false); 
final ViewHolder holder = new ViewHolder (view); 
View.setonCclickListener(new View.0nClickListener() { 
@override 


public void onClick(View v) { 
News news = mNewsList.get(holder.getAdapterPosition()); 
if (isTwoPane) 
// 如 果 是 双 页 模式 ， 则 刷新 NewsContentFragment 中 的 内 容 
NewsContentFragment newsContentFragment = 
(NewsContentFragment) getFragmentManager() 
.findFragmentById(R.id.news_content_fragment); 
newsContentFragment.refresh(news.getTitle(), 
news.getcontent()); 
} else { 
// 如 果 是 单 页 模式 ， 则 直接 启动 NewsContentActivity 
NewsContentActivity.actionStart(getActivity()， 
news.getTitle(), news.getContent()); 





}); 
return holder; 


} 


@Override 

public void onBindviewHolder (ViewHolder holder, int position) { 
News news = mNewsList.get(position); 
holder .newsTitleText.setText(news.getTitle()); 


@override 
public int getItemCount() { 
return mNewsList.size(); 


Recyclerview 的 用 法 你 已 经 相当 熟练 了 ， 因 此 这 个 适配器 的 代码 对 你 来 
人 
个 独立 的 类 ， 其 实 也 是 可 以 写成 内 部 类 的 ， 这 里 写成 内 部 类 的 好 处 就 是 
可 以 直接 访问 NewsTitleFragment 的 变量 ， 比 如 isTwoPane。 


观察 一 下 oncreateviewHolder() 方 法 中 注册 的 点 击 事 件 ， 首 先 获 取 到 了 
点 击 项 的 News 实 例 ， 然 后 通过 isTwoPane 变 量 来 判断 当前 是 单 页 还 是 双 
页 模式 ， 如 果 是 单 页 模式 ， 就 启动 一 个 新 的 活动 去 显示 新 闻 内 容 ， 如 果 
是 双 页 模式 ， 就 更 新 新 闻 内 容 碎片 里 的 数据 。 


现在 还 剩 最 后 一 步 收尾 工作 ， 束 是 阿 Recyclerview 中 填充 数据 了 。 修 
改 NewsTitleFragment 中 的 代码 ， 如 下 所 示 : 


public class NewsTitleFragment extends Fragment { 








@override 
public View onCreateView(LayoutInflater inflater, ViewGroup container 
Bundle savedInstanceState) { 
View view = inflater.inflate(R.]layout.news_title_ frag, container, false); 
RecyclerView newsTitleRecyclerView = (RecyclerView) view.findViewById 
(R.id.news_title_ recycler_view); 
LinearLayoutManager layoutManager = new LinearLayoutManager (getActivity()); 
newsTitleRecyclerView.setLayoutManager (layoutManager); 
NewsAdapter adapter = new NewsAdapter (getNews()); 
newsTitleRecyclerView.setAdapter (adapter); 
return view; 


} 


private List<News> getNews() { 
List<News> newsList = new ArrayList<>(); 
for (int i = 1; i <= 50; i++) { 
News news = new News(); 
news.setTitle("This is news title " + i); 
news.setcontent(getRandomLengthContent("This is news content " + i+". ")); 
newsList.add(news); 


private String ge etRan domLe ntent(String content ) { 
ndom random ne a ndo 
nt ‘le ngth = = random tn nt(20) + 
str 二 本 bu ilde = new Str 私人 ilder(); 
for 0 a gen +] 
站 .appe ae dnt nt); 


return builder.toString(); 
了 


可 以 看 到 ，oncreateview() 方 法 中 添加 了 Recyclerview 标 准 的 使 用 方 

法 ， 在 碎片 中 使 用 Recyclerview 和 在 活动 中 使 用 几乎 是 一 模 一 样 的 ， 相 
信 没 有 什么 需要 解释 的 。 另 外 ， 这 里 调用 了 getNews() 方 法 来 初始 化 50 
条 模拟 新 闻 数 据 ， 同 样 使 用 了 一 个 getRandomLengthcontent () 方 法 来 随 
机 生成 新 闻 内 容 的 长 度 ， 以 保证 每 条 新 闻 的 内 容 差 距 比较 大 ， 相 信 你 对 
这 个 方法 肯定 不 会 陌生 了 。 


这 样 我 们 所 有 的 编写 工作 就 已 经 完成 了 ， 赶 快 来 运行 一 下 吧 ! 首先 在 手 
机 模拟 器 上 运行 ， 效 果 如 图 4.14 所 示 。 
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图 4.14 单 页 模式 的 新 闻 列 表 界 面 


可 以 看 到 许多 条 新 闻 的 标题 ， 然 后 点击 第 一 条 新 闻 ， 会 月 动 一 个 新 的 活 
动 来 显示 新 闻 的 内 容 ， 效 果 如 图 4.15 所 示 。 
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图 4.15 单 页 模式 的 新 闻 内 容 界 面 


0 同样 点 击 第 一 条 新 闻 ， 效 果 如 图 
4.16 所 不 。 
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图 4.16 双 页 模式 的 新 闻 标 题 和 内 容 界 面 


怎么 样 ? 同样 的 一 份 代码 ， 在 手机 和 平板 上 运行 却 分别 是 两 种 完全 不 同 
的 效果 ， 说 明 我 们 程序 的 兼容 性 已 经 相当 不 错 了 。 通 过 这 个 例子 ， 9 
信 你 对 雄 片 的 理解 一 定 又 加 深 了 很 多 ， 现 在 就 让 我 们 一 起 来 总 结 一 

吧 。 








4.6 小结 与 氮 评 


你 应 该 可 以 感觉 到 ， 上 一 节 中 我 们 开发 的 新 闻 应 用 ， 代 码 复杂 度 还 是 有 
点 高 的 ， 比 起 只 需要 兼容 一 个 终端 的 应 用 ， 我 们 要 考虑 的 东西 多 了 很 
多 。 不 过 在 开发 的 过 程 中 多 付出 一 些 ， 在 以 后 的 代码 维护 中 就 可 以 轻松 
很 多 。 因 此 ， 有 时 候 提 前 的 付出 还 是 很 值得 的 。 


我 们 再 来 回顾 一 下 本 章 所 学 的 内 容 吧 ， 首 先 你 了 解 了 碎片 的 基本 概念 以 
及 使 用 场景 ， 接 着 通过 几 个 实例 掌握 了 碎片 的 第 见 用 法 ， 随 后 又 学 习 了 
人 雄 片 生命 周期 的 相关 内 容 以 及 动态 加 载 布局 的 技巧 ， 最 后 在 本 革 的 最 佳 
实践 部 分 将 前 面 所 学 的 内 容 综 合 运 用 了 一 过， 相信 你 已 经 将 寿 片 相关 知 
识 点 都 牢记 在 心 ， 并 可 以 较为 熟练 地 应 用 了 。 


本 章 其 实 是 具有 一 个 里 程 碑 式 的 纪念 意义 的 ， 因 为 到 这 里 为 止 ， 我 们 已 
经 基本 将 Android UI 相关 的 重要 知识 点 都 讲 完了 。 后 面 在 很 长 一 段 时 间 
内 都 不 会 再 系统 性 地 介绍 UT 方 面 的 知识 ， 而 是 将 结合 前 面 所 学 的 UI 知 识 
来 更 好 地 讲解 相应 章节 的 内 容 。 那 么 我 们 下 一 章 将 要 学 习 什 么 呢 ? 还 记 
得 在 第 1 章 里 介绍 过 的 Android 四 大 组 件 吧 ? 目前 我 们 只 掌握 了 活动 这 一 
人 

1 并) 
































第 5 革 全 局 大 喇叭 一 一 详解 广播 机 
制 | 


记得 在 我 上 学 的 时 候 ， 每 个 班级 的 教室 里 都 会 装 有 一 个 喇叭 ， 这 些 喇 以 
都 是 接 入 到 学 校 的 广播 室 的 ， 一 旦 有 什么 重要 的 通知 ， 就 会 播放 一 条 广 
播 来 告知 全 校 的 师 生 。 类 似 的 工作 机 制 其 实在 计算 机 领域 也 有 很 广泛 的 
应 用 ， 如 果 你 了 解 网 络 通信 原理 应 该 会 知道 ， 在 一 个 了 网 络 范围 中 ， 最 
大 的 IP 地 址 是 被 保留 作为 广播 地 址 来 使 用 的 。 比 如 某 个 网 络 的 人 P 范 围 是 
192.168.0.XXX， 子 网 掩 码 是 255.255.255.0， 那 么 这 个 网 络 的 广播 地 址 就 
是 192.168.0.255。 广 播 数据 包 会 被 发 送 到 同一 网 络 上 的 所 有 端口 ， 这 样 
在 该 网 络 中 的 每 台 主 机 都 将 会 收 到 这 条 广播 。 


为 了 便于 进行 系统 级 别 的 消息 通知 ，Android 也 引入 了 一 套 类 似 的 广播 
消息 机 制 。 相 比 于 我 前 面 举 出 的 两 个 例子 ，Android 中 的 广播 机 制 会 显 
得 更 加 灵活 ， 本 章 束 将 对 这 一 机 制 的 方方面面 进行 详细 的 讲解 。 














5.1 广播 机 制 简 介 


为 什么 说 Android 中 的 广播 机 制 更 加 灵活 呢 ? 这 是 因为 Android 中 的 每 个 
应 用 程序 都 可 以 对 上 自己 感 兴 趣 的 广播 进行 注册 ， 这 样 该 程序 就 只 会 接收 
到 目 己 所 关心 的 广播 内 容 ， 这 些 广播 可 能 是 来 和 目 于 系统 的 ， 也 可 能 是 来 
自 于 其 他 应 用 程序 的 。Android 提 供 了 一 套 完整 的 API， 人 允许 应 用 程序 自 
由 地 发 送 和 接收 广播 。 发 送 广播 的 方法 其 实 之 前 稍微 提 到 过 ， 如 果 你 记 
性 好 的 话 可 能 还 会 有 印象 ， 束 是 借助 我 们 第 2 章 学 过 的 Intent。 而 接收 广 
播 的 方法 则 需要 引入 一 个 新 的 概念 一 一 广播 接收 器 〈Broadcast 
Receiver) 。 

广播 接收 器 的 具体 用 法 将 会 在 下 一 节 中 做 介绍 ， 这 里 我 们 先 来 了 解 一 下 
0 Android 中 的 广播 主要 可 以 分 为 两 种 类 型 : 标准 广播 和 有 
邓 广 播 。 




















。 标准 广播 (Normal broadcasts) 是 一 种 完全 异步 执行 的 广播 ， 在 厂 
播发 出 之 后 ， 所 有 的 广播 接收 绒 几 乎 都 会 在 同一 时 刻 接收 到 这 条 广 
播 消 息 ， 因 此 它们 之 间 没 有 任何 先后 顺序 可 言 。 这 种 广播 的 效率 会 
人 标准 广播 的 工作 流程 
果 和 氏 5.1 及 未。 
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图 5.1 标准 广播 工作 示意 图 


。 有 序 广播 《Ordered broadcasts) 则 是 一 种 同步 执行 的 广播 ， 在 广播 
发 出 之 后 ， 同 一 时 刻 只 会 有 一 个 广播 接收 喜 能 够 收 到 这 条 广播 消 
晨 ， 当 这 个 广播 接收 器 中 的 逻辑 执行 完毕 后 ， 广 播 才 会 继续 传递 。 
所 以 此 时 的 广播 接收 喜 是 有 先后 顺序 的 ， 优 先 级 高 的 广播 接收 器 就 
可 以 先 收 到 广播 消 晨 ， 并 且 前 面 的 广播 接收 器 还 可 以 截断 正在 传递 
的 广播 ， 这 样 后 面 的 广播 接收 旨 就 无 法 收 到 广播 消 恩 了 。 有 序 广播 
的 工作 流程 如 图 5.2 所 示 。 
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可 将 广播 截断 | ”可 将 广播 截断 











图 5.2 有 序 广播 工作 示意 图 


掌握 了 这 些 基 本 概念 后 ， 我 们 就 可 以 来 尝试 一 下 广播 的 用 法 了 ， 首 先 就 
从 接收 系统 三 播 开 始 吧 。 





5.2 ”接收 系统 广播 


Android 内 置 了 很 多 系统 级 别 的 广播 ， 我 们 可 以 在 应 用 程序 中 通过 监听 
这 些 广播 来 得 到 各 种 系统 的 状态 信息 。 比 如 手机 开机 完成 后 会 发 出 一 条 
广播 ， 电 池 的 电量 发 生变 化 会 用 出 一 条 广播 ， 时 间或 时 区 发 生 改 变 也 会 
发 出 一 条 广播 ， 等 等 。 如 休想 要 接收 到 这 些 广 播 ， 束 需要 使 用 广播 接收 
项 ， 下 面 我 们 就 来 看 一 下 筷 的 具体 用 法 。 


5.2.1 动态 注册 监听 网 络 变化 


广播 接收 器 可 以 自由 地 对 自己 感 兴趣 的 广播 进行 注册 ， 这 样 当 有 相应 的 
广播 发 出 时 ， 广 播 接 收 器 就 能 够 收 到 该 广播 ， 并 在 内 部 处 理 相应 的 逻 
辑 。 注 册 广 播 的 方式 一 般 有 两 种 ， 在 代码 中 注册 和 在 
AndroidManifest.xml 中 注册 ， 其 中 前 者 也 被 称 为 动态 注册 ， 后 者 也 被 称 

为 静态 注册 。 


那么 该 如 何 创 建 一 个 广播 接收 器 呢 ? 其 实 只 需要 新 建 一 个 类 ， 让 它 继承 
自 BroadcastReceiver， 并 重 写 父 类 的 onReceive() 方 法 就 行 了 。 这 样 当 
有 广播 到 来 时 ，onReceive() 方 法 就 会 得 到 执行 ， 具 体 的 逻辑 就 可 以 在 
这 个 让 估 中 人 于 


那 我 们 就 先 通过 动态 注册 的 方式 编号 一 个 能 够 监听 网 络 变化 的 程序 ， 借 
此 学 习 一 下 广播 接收 器 的 基本 用 法 吧 。 新 建 一 个 BroadcastTest 项 目 ， 然 
后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 











private IntentFilter intentFilter; 


private NetworkChangeReceiver networkChangeReceiver; 


@override 
pr rote cte ed od nCreate(Bun De SavedInstanceState) { 
ES ed cestate); 


eteon te CE iew(R. a ayo BE vt Any; 
tent bo = newI SET Es 
atone a on andes net. ON CSS CHANGE" ); 
Derwor Kohange eReceive Ww Ne or kehan nge Sec cei 
registerReceiver(ne tor Ch nge nt 上 ite er); 


} 


@Ooverride 
protected void onDestroy() { 
super .onDestroy(); 
unregisterReceiver(networkChangeReceiver); 
} 


class NetworkChangeReceiver extends BroadcastReceiver { 


@Override 


ceive(Context context, Intent intent) { 
context, "network changes", Toast.LENGTH_SHORT).show(); 


可 以 看 到 ， 我 们 在 MainActivity 中 定义 了 一 个 内 部 

类 NetworkchangeReceiver， 这 个 类 是 继承 目 BroadcastReceiver 的 ， 并 
重 写 了 父 类 的 onReceive() 方 法 。 这 样 每 当 网 络 状 态 发 生变 化 

时 ，onReceive() 方 法 就 会 得 到 执行 ， 这 里 只 是 简单 地 使 用 Toast 提 示 了 
二 投 广 本 信息 : 


然后 观察 oncreate() 方 法 ， 首 先 我 们 创建 了 一 个 IntentFilter 的 实例 ， 
并 给 它 添加 了 一 个 值 为 android.net .conn.CONNECTIVITY_CHANGE 的 
action， 为 什么 要 添加 这 个 值 呢 ?” 因 为 当 网 络 状态 发 生变 化 时 ， 系 统 发 
出 的 正 是 一 条 值 为 android.net.conn.CONNECTIVITY_CHANGE 的 广播 ， 也 
束 是 说 我 们 的 广播 接收 绒 想 要 监听 什么 广播 ， 吏 在 这 里 添加 相应 的 
action 。 接 下 来 创建 了 一 | NetworkchangeReceiver 的 实例 ， 然后 调 

用 registerReceiver( ) 方 法 进行 注册 ， 将 NetworkchangeReceiver 的 实例 
和 IntentFilter 的 实例 都 传 了 进去 ， 这 样 NetworkchangeReceiver 就 会 收 
到 所 有 值 为 android.net.conn.CONNECTIVITY_CHANGE 的 广播 ， 也 就 实现 
了 监听 网 络 变化 的 功能 。 


最 后 要 记得 ， 动 态 注 册 的 广播 接收 需 一 定 都 要 取消 注册 才 行 ， 这 里 我 们 
是 在 onDestroy() 方 法 中 通过 调用 unregisterReceiver() 方 法 来 实现 的 。 


整体 来 说 ， 代 码 还 是 非常 简单 的 ， 现 在 运行 一 下 程序 。 首 先 你 会 在 注册 
完成 的 时 候 收 到 一 条 广播 ， 然 后 按 下 Home 键 回 到 主 界面 (注意 不 能 按 
Back 键 ， 否 则 onpDestroy() 方 法 会 执行 ) ， 接着 打开 Settings 程 序 — Data 
usage 进 入 到 数据 使 用 详情 界面 ， 然 后 尝试 着 开关 Cellular data 按 钮 来 启 
动 和 禁用 网 络 ， 你 束 会 看 到 有 Toast 提 醒 你 网 络 发 生 了 变化 。 


不 过 ， 只 是 提醒 网 络 发 生 了 变化 还 不 够 人 性 化 ， 最 好 是 能 准确 地 告诉 用 
户 当 前 是 有 网 络 还 是 没有 网 络 ， 因 此 我 们 还 需要 对 上 面 的 代码 进行 进 一 
步 的 优化 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 

















class NetworkChangeReceiver extends BroadcastReceiver { 


verride 
public void onReceive(Context context, Intent intent) { 


9 ctionManager = (Con vityManager) 
getSystemse EEL onte xt. CONNECTIVITY -SERVICE 
Networ Kin Qe ne eo kInfo connectio ager .getActiveNetworkInfo(); 
if (ne 如 nfo != null 二 ne or kinfo isAvatiat1 80) { 
Toa SE akeText (conte. k is availab 
Toast . WENETH RDS Spot) 
} else { 
St 
Toa 


Toa makeText nte ork is unavailable" 


(co 
st .LENGTH RT han 


在 onReceive( ) 方 法 中 ， 首 先 通 过 getsystemService() 方 法 得 到 了 

connectivityManager 的 实例 ， 这 是 一 个 系统 服务 类 ， 专 门 用 于 管理 网 络 

连接 的 。 然 后 调用 它 的 getActiveNetworkInfo() 方 法 可 以 得 

到 NetworkInfo 的 实例 ， i 就 

es 最 后 我 们 还 过 Toast 的 方式 对 用 户 
行 提示 


男 外 ， 这 里 有 非常 重要 的 一 点 需要 说 明 ，Android 系 统 为 了 保护 用 户 设 

备 的 安全 和 隐私 ， 做 了 严格 的 规定 : 如 果 程 序 需要 进行 一 些 对 用 户 来 说 
比较 敏感 的 操作 ， 就 必须 在 配置 文件 中 声明 权限 才 可 以 ， 人 否则 程序 将 会 
直接 裔 溃 。 比 如 这 里 访问 系统 的 网 络 状 态 就 是 需要 声明 权限 的 。 打 开 

EE ， 在 里 面 加 入 如 下 权限 就 可 以 访问 系统 网 络 状 
在 了 了 : 











nifest xm Ds a roid="http://schemas.android.com/apk/res/android" 
pa ackage= xample.broadcasttest"> 


<uses -permission android:name="android.permission.ACCESS_NETWORK_STATE" /> 


</manifest> 


这 是 你 第 一 次 过 到 权限 的 问题 ， 其 实 Android 中 有 许多 操作 都 是 需要 声 
明 权 限 才 可 以 进行 的 ， 后 面 我 们 还 会 不 断 使 用 新 的 权限 。 不 过 目前 这 个 
访问 系统 网 络 状 态 的 权限 还 是 比较 简单 的 ， 只 需要 在 
AndroidManifest.xml 文 件 中 声明 一 下 就 可 以 了 ， 而 Android 6.0 系 统 中 引 
入 了 更 加 严格 的 运行 时 权限 ， 从 而 能 够 更 好 地 保证 用 户 设备 的 安全 和 隐 
私 ， 关 于 这 部 分 内 容 我 们 将 在 第 7 章 中 学 习 。 


现在 重新 运行 程序 ， 然 后 按 下 Home 键 Settings Data usage， 进 入 到 数 
据 使 用 详情 界面 ， 关 闭 Cellular ”data 会 弹出 无 网 络 可 用 的 提示 ， 如 图 5.3 
所 示 。 



















Data usage 








Usage 


| 1 MB cellular data 


ep 24 ~ Uct 


Data saver 


Cellular 
Cellular data 


Cellular data usage 
1 .2723 MB used between pn . 


network is unavailable 





图 5.3 禁用 系统 网 络 
然后 重新 打开 Cellular data 又 会 弹出 网 络 可 用 的 提示 ， 如 图 5.4 所 示 。 
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图 5.4 启用 系统 网 络 
5.2.2 ”静态 注册 实现 开机 启动 


动态 注册 的 广播 接收 器 可 以 自由 地 控制 注册 与 注销 ， 在 灵活 性 方面 有 很 
大 的 优势 ， 但 是 它 也 存在 着 一 个 缺点 ， 即 必须 要 在 程序 启动 之 后 才能 接 
收 到 广播 ， 因 为 注册 的 逻辑 是 写 在 oncreate() 方 法 中 的 。 那 么 有 没有 什 
么 办 法 可 以 让 程序 在 未 局 动 的 情况 下 就 能 接收 到 广播 呢 ? 这 就 需要 使 用 
静态 注册 的 方式 了 。 

这 里 我 们 准备 让 程序 接收 一 条 开机 广播 ， 当 收 到 这 条 广播 时 就 可 以 

在 onReceive() 方 法 里 执行 相应 的 逻辑 ， 从 而 实现 开机 局 动 的 功能 。 可 
以 使 用 Android Studio 提 供 的 快捷 方式 来 创建 一 个 广播 接收 绒 ， 右 击 








com.example.broadcasttest 包 ~ New -Other “Broadcast Receiver， 会 弹出 
如 图 5.5 所 示 的 窗口 。 


下 New Android Component 








Configure Component 


人 Android Studio 


Creates a new broadcast receiver component and adds it to your Android manifest. 


Class Name: BootCompleteReceiver 


Exported 





Enabled 











图 5.5 创建 广播 接收 喜 的 窗口 


可 以 看 到 ， 这 里 我 们 将 广播 接收 器 命名 为 BootCompleteReceiver， 
Exported 属 性 表示 是 否 允 许 这 个 广播 接收 器 接收 本 程序 以 外 的 广 

播 ，Enabled 属 性 表示 是 否 启用 这 个 广播 接收 器 。 勾 选 这 两 个 属性 ， 点 
击 Finish 完 成 创建 。 


然后 修改 BootCompleteReceiver 中 的 代码 ， 如 下 所 示 : 


public class BootCompleteReceiver extends BroadcastReceiver { 








@override 
public void onReceive(Context context, Intent intent) { 
Toast.makeText(context, "Boot Complete", Toast.LENGTH_LONG).show(); 


代码 非常 简单 ， 我 们 只 是 在 onReceive() 方 法 中 使 用 Toast 弹 出 一 段 提 示 


> 
号 4D Oo 


另外 ， 静 态 的 广播 接收 器 一 定 要 在 AndroidManifest,xml 文 件 中 注册 才 可 
以 使 用 ， 不 过 由 于 我 们 是 使 用 Android Studio 的 快捷 方式 创建 的 广播 接收 
全 这 一 步 已 经 被 自动 完成 了 。 打 开 AndroidManifest.xml 文 件 
扒 一 瞧 ， 人 代码 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcasttest"> 





<uses-permission android:name="android.permission.ACCESS_ NETWORK_STATE" /> 
<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<receiver 
android:name=" 人 eV 
android:enabled=" 
android:exported=" Ee > 
</receiver> 
</application> 


</manifest> 


可 以 看 到 ，<application> 标 签 内 出 现 了 一 个 新 的 标签 <receiver>， 所 有 
静态 的 广播 接收 器 都 是 在 这 里 进行 注册 的 。 它 的 用 法 其 实 和 <activity> 
标签 非常 相似 ， 也 是 通过 android:name 来 指定 具体 注册 哪 一 个 广播 接收 
而 enabled 和 exported 属 性 则 是 根据 我 们 刚才 勾 选 的 状态 自动 生成 


不 过 目前 BootCompleteReceiver 还 是 不 能 接收 到 开机 广播 的 ， 我 们 还 需 
要 对 AndroidManifest.xml 文 件 进行 修改 才 行 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcasttest"> 








<uses-permission android:name="android.permission.ACCESS_ NETWORK_STATE" /> 
<uses-permission android:name="android.permission.RECEIVE_ BOOT_COMPLETED" /> 


<application 

android:allowBackup="true" 

android:icon="@mipmap/ic_launcher" 

android:label="@string/app_name" 

android:supportsRtl="true" 

android:theme="@style/AppTheme"> 

<receiver 
android:name=".BootCompleteReceiver" 
android:enabled="true 
android:exported="true"> 


droid:name="android.intent.action.BOOT_COMPLETED" /> 





由 于 Android 系 统 启动 完成 后 会 发 出 一 条 值 

为 android.intent.action.B0OOT_COMPLETED 的 广播 ， 因 此 我 们 在 <intent- 
filter> 标 签 里 添加 了 相应 的 action。 另 外 ， 监 听 系 统 开 机 广播 也 是 需要 
声明 权限 的 ， 可 以 看 到 ， 我 们 使 用 <uses-permission> 标 签 又 加 入 了 一 


条 android.permission.RECEIVE_BOOT_COMPLETED 权 限 。 











现在 重新 运行 程序 后 ， 我 们 的 程序 就 已 经 可 以 接收 开机 广播 了 。 将 模拟 
费 关 闭 并 重新 局 动 ， 在 启动 完成 之 后 束 会 收 到 开机 广播 ， 如 图 5.6 所 
外。 








图 5.6 接收 系统 开机 广播 


到 目前 为 止 ， 我 们 在 广播 接收 器 的 onReceive() 方 法 中 都 只 是 简单 地 使 
用 Toast 提 示 了 一 段 文本 信息 ， 当 你 真正 在 项 目 中 使 用 到 它 的 时 候 ， 就 
可 以 在 里 面 编写 自己 的 逻辑 。 需 要 注意 的 是 ， 不 要 在 onReceive() 方 法 
中 添加 过 多 的 逻辑 或 者 进行 任何 的 耗 时 操作 ， 因 为 在 广播 接收 器 中 是 不 
允许 开局 线程 的 ， 当 onReceive() 方 法 运行 了 较 长 时 间 而 没有 结束 时 ， 
程序 就 会 报错 。 因 此 广播 接收 堪 更 多 的 是 扮演 一 种 打开 程序 其 他 组 件 的 
角色 ， 比 如 创建 一 条 状态 栏 通知 ， 或 者 启动 一 个 服务 等 ， 这 几 个 概念 我 
们 会 在 后 面 的 章节 中 学 到 。 





5.3 ”发 送 目 定义 厂 播 
现在 你 已 经 学 会 了 通过 广播 接收 器 来 接收 系统 广播 ， 接 下 来 我 们 就 要 学 
习 一 下 如 何在 应 用 程序 中 发 送 自 定 义 的 广播 。 前 面 已 经 介绍 过 了 ， 广 播 
主要 分 为 两 种 类 型 : 标准 广播 和 有 序 广播 ， 在 本 节 中 我 们 就 将 通过 实践 
的 方式 来 看 一 下 这 两 种 广播 具体 的 区 别 。 


5.3.1 发送 标准 广播 
在 发 送 广播 之 前 ， 我 们 还 是 需要 先 定 义 一 个 广播 接收 喜来 准备 接收 此 广 


播 才 行 ， 不 然 发 出 去 也 是 白 发 。 因 此 新 建 一 个 MyBroadcastReceiver， 代 
码 如 下 所 示 : 


public class MyBroadcastReceiver extends BroadcastReceiver { 

















@Override 
public void onReceive(Context context, Intent intent) { 
Toast.makeText(context, "received in MyBroadcastReceiver", Toast.LENGTH_ 
SHORT). show(); 
} 


这 里 当 MyBroadcastReceiver 收 到 目 定 义 的 广播 时 ， 就 会 弹出 “received in 
MyBroadcastReceiver” 的 提示 。 然 后 在 AndroidManifest.xml 中 对 这 个 广播 
接收 器 进行 修改 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcasttest"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportSsRt1="true" 
android:theme="@style/AppTheme"> 
<receiver 
android:name=".MyBroadcastReceiver" 
android:enabled="true" 
android:exported="true"> 
<intent-filter> 
<action android:name="com.example.broadcasttest .MY_BROADCAST"/> 
</intent-filter> 
</receiver> 
</application> 
</manifest> 


可 以 看 到 ， 这 里 让 MyBroadcastReceiver 接 收 一 条 值 
为 com example.broadcasttest.MY_BROADCAST 的 广播 ， 因 此 待 会 儿 在 发 


送 广 播 的 时 候 ， 我 们 就 需要 发 出 这 样 的 一 条 广播 。 
接 下 来 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns: android= ee //schemas.android.com/apk/res/android" 
android:orientation="verti 
android:layout_width= “niatch von 
android:layout_height="match_parent" > 


<Button 
android:id="@+id/button" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Send Broadcast" 
/> 


</LinearLayout> 





这 里 在 布局 文件 中 定义 了 一 个 按钮 ， 用 于 作为 发 送 广播 的 触发 点 。 然 后 
修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity_ main); 
Button button = (Button) findViewById(R.id.button); 
button.setonCclickListener(new View.0nCclickListener() { 


可 以 看 到 ， 


@override 

public void 人 v){ 
Intent intent = 
Intent("com. aie broadcasttest .MY_BROADCAST"); 
sendBroadcast (intent); 


我 们 在 按钮 的 点 击 事件 里 面 加 入 了 发 送 自 定义 广播 的 逻辑 。 


首先 构建 出 了 一 个 Intent 对 象 ， 并 把 要 发 送 的 广播 的 值 传 入 ， 然 后 调用 
了 Context 的 sendBroadcast() 方 法 将 广播 发 送出 去 ， 这 样 所 有 监 
听 com.example.broadcasttest.MY_BROADCAST 这 条 广播 的 广播 接收 器 就 


会 收 到 消息 


重新 运行 





上 县。 此 时 发 出 去 的 广播 就 是 一 条 标准 广播 。 
程序 ， 并 点 击 一 下 Send Broadcast 按 钮 ， 效 果 如 图 5.7 所 示 。 
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图 5.7 接收 到 目 定义 广播 

这 样 我 们 就 成 功 完 成 了 发 送 自 定义 广播 的 功能 。 男 外 ， 由 于 广播 是 使 用 

人 因此 你 还 可 以 在 Intent 中 携带 一 些 数据 传递 给 广播 接 
3 


5.3.2 发 送 有 序 广播 


广播 是 一 种 可 以 跨 进 程 的 通信 方式 ， 这 一 点 从 前 面 接收 系统 广播 的 时 候 
就 可 以 看 出 来 了 。 因 此 在 我 们 应 用 程序 内 发 出 的 广播 ， 其 他 的 应 用 程序 
应 该 也 是 可 以 收 到 的 。 为 了 验证 这 一 点 ， 我 们 需要 再 新 建 一 个 
BroadcastTest2 项 目 ， 点 击 Android Studio 导 航 栏 .File .; New ,New 
Project 进 行 创建 。 


将 项 目 创建 好 之 后 ， 还 需要 在 这 个 项 目下 定义 一 个 广播 接收 右 ， 用 于 接 








收 上 一 人 小节 中 的 自 冠 又 三 播 。 新 建 AnotherBroadcastReceiver， 代码 如 
下 所 示 : 


public class AnotherBroadcastReceiver extends BroadcastReceiver { 


@override 
public void onReceive(Context context, Intent intent) 
Toast.makeText(context, "received in AnotherBroadcastReceiver" 
Toast .LENGTH_SHORT) .show() ; 
} 


这 里 仍然 是 在 广播 接收 器 的 onReceive( ) 方 法 中 弹出 了 一 段 文本 信息 。 
然后 在 AndroidManifest.xml 中 对 这 个 广播 接收 器 进行 修改 ， 代 码 如 下 所 
示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcasttest2"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<receiver 
android:name=" .AnotherBroadcastReceiver" 
android:enabled="true 
android:exported="true"> 
<intent-filter> 
<action android:name="com.example.broadcasttest.MY_BROADCAST" /> 
</intent-filter> 
</receiver> 
</application> 


</manifest> 


可 以 看 到 ，AnotherBroadcastReceiver 同 样 接收 的 

是 com.example.broadcasttest.MY_BROADCAST 这 条 广播 。 现 在 运行 
BroadcastTest2 项 目 将 这 个 程序 安装 到 模拟 器 上 ， 然 后 重新 回 到 
BroadcastTest 项 目的 主 界面 ， 并 点 击 一 下 Send Broadcast 按 钮 ， 束 会 分 别 
弹出 两 次 提示 信息 ， 如 图 5.8 所 示 。 
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图 5.8 ”两 个 程序 中 都 接收 到 自 定义 广播 


这 样 就 强 有 力 地 证 明了 ， 我 们 的 应 用 程序 友 出 的 广播 是 可 以 被 其 他 的 应 
用 程序 接收 到 的 。 


不 过 到 目前 为 止 ， 程 序 里 发 出 的 都 还 是 标准 广播 ， 现 在 我 们 来 尝试 一 下 
发 送 有 序 广播 。 重 新 回 到 BroadcastTest 项 目 ， 然 后 修改 MainActivity 中 的 
代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


@Override 
protected void onCreate(Bundle SavedInstanceState) { 
super .onCreate(savedIinstanceSstate); 
setContentView(R.1layout.activity_main); 
Button button = (Button) findViewById(R.id.button); 
button.setonCclickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
Intent intent = 
Intent("com.example.broadcasttest .MY_BROADCAST"); 
sendorderedBroadcast(intent, null); 





可 以 看 到 ， 发 送 有 序 广播 只 需要 改动 一 行 代码 ， 即 将 sendBroadcast () 方 
法 改 成 sendorderedBroadcast( ) 方 法 。sendorderedBroadcast() 方 法 接收 
两 个 参数 ， 第 一 个 参数 仍然 是 Intent， 第 二 个 参数 是 一 个 与 权限 相关 的 
字符 串 ， 这 里 传 入 nul1 就 行 了 。 现 在 重新 运行 程序 ， 并 点 击 Send 
Broadcast 按 钮 ， 你 会 发 现 ， 两 个 应 用 程序 仍然 都 可 以 接收 到 这 条 广播 。 


看 上 去 好 像 和 标准 广播 没什么 区 别 咏 ， 不 过 别 生 了， 这 个 时 候 的 广播 接 
人 而 且 前 面 的 广播 接收 器 还 可 以 将 广播 截断 ， 以 阻 
其 继续 


那么 该 如 何 设 定 广播 接收 器 的 先后 顺序 呢 ? 当然 是 在 注册 的 时 候 进行 设 
定 的 了 ， 修 改 AndroidManifest.xml 中 的 代码 ， 如 下 所 示 : 




















manife mS a oid= es A chemas An oid.com/apk/res/android" 
pac SE age= .example.broadcastte t2" 


al 
U 
them 
<receiver 
android:name=" .MyBr d astR' 
android:enabled="tr 
android:exported="t 
intent-filter android:pri es '100" 
<action nanold anc eon ample br oadcasttest.MY_BROADCAST" /> 
/intent-filter> 
</ iver> 
/applicat 
/ ifest 


可 以 看 到 ， 我 们 通过 android:priority 属 性 给 广播 接收 器 设置 了 优先 
级 ， 优 先 级 比较 高 的 广播 接收 器 就 可 以 先 收 到 广播 。 这 里 将 
MyBroadcastReceiver 的 优先 级 设 成 了 100， 以 保证 它 一 定 会 在 
AnotherBroadcastReceiver 之 前 收 到 广播 。 








既然 已 经 获得 了 接收 广播 的 优先 权 ， 那 么 MyBroadcastReceiver 就 可 以 选 
择 是 否 人 允许 广 播 继 续 传 递 了 。 修 改 MyBroadcastReceiver 中 的 代码 ， 如 下 
所 示 : 


public class MyBroadcastReceiver extends BroadcastReceiver { 


@override 
public void onReceive(Context context, Intent intent) { 
Toast.makeText(context, "received in MyBroadcastReceiver" 
Toast .LENGTH_SHORT) .show() ; 
abortBroadcast(); 


如 果 在 onReceive( ) 方 法 中 调用 了 abortBroadcast() 方 法 ， 就 表示 将 这 条 
广播 截断 ， 后 面 的 广播 接收 绒 将 无 法 再 接收 到 这 条 广播 。 现 在 重新 运行 
程序 ， 并 点 击 一 下 Send Broadcast 按 钮 ， 你 会 发 现 ， 只 有 
MyBroadcastReceiver 中 的 Toast 信 息 能 够 弹出 ， 说 明 这 条 广播 经 过 
MYyBroadcastReceiver 之 后 确实 是 终止 传递 了 。 


5.4 使 用 本 地 广播 


前 面 我 们 发 送 和 接收 的 广播 全 部 属于 系统 全 局 广播 ， 即 发 出 的 广播 可 以 
被 其 他 任何 应 用 程序 接收 到 ， 并 且 我 们 也 可 以 接收 来 目 于 其 他 任何 应 用 
程序 的 广播 。 这 样 束 很 容易 引起 安全 性 的 问题 ， 比 如 说 我 们 友 送 的 一 些 
携带 关键 性 数据 的 广播 有 可 能 被 其 他 的 应 用 程序 截获 ， 或 者 其 他 的 程序 
不 集 地 同 我 们 的 广播 接收 器 里 及 送 各 种 垃圾 广播 。 


为 了 能 够 简单 地 解决 广播 的 安全 性 问题 ，Android 引 入 了 一 套 本 地 广播 
机 制 ， 使 用 这 个 机 制 发 出 的 广播 只 能 够 在 应 用 程序 的 内 部 进行 传递 ， 并 
且 广播 接收 器 也 只 能 接收 来 自 本 应 用 程序 发 出 的 广播 ， 这 样 所 有 的 安全 
性 问题 就 都 不 存在 了 。 


本 地 广播 的 用 法 并 不 复杂 ， 主 要 就 是 使 用 了 一 个 LocalBroadcastManager 
来 对 广播 进行 管理 ， 并 提供 了 发 送 广播 和 注册 广播 接收 器 的 方法 。 下 面 
修改 MainActivity 中 的 代 
伍 ， 中 下 所 示 : 


public class MainActivity extends AppCompatActivity { 























private IntentFilter intentFilter; 
private LocalReceiver localReceiver; 
private LocalBroadcastManager localBroadcastManager; 


@override 
protected void onCreate(Bundle SavedInstanceState) { 
Super .oncCcreate(SavedInstanceState) 
setContentView(R.1layout.activity_main); 
localBroadcastManager = LocalBroadcastManager. per netancet tae), // 获取 实例 
Button button = (Button) findViewById(R.id.button); 
button.setOnclickListener(new View.OnClickListener() { 
@override 
public void onClick(View v) { 
Intent intent = new Intent("com.example.broadcasttest.LOCAL_ 
BROADCAST" ) ; 
localBroadcastManager .sendBroadcast(intent); // 发 送 本 地 广播 


}); 

intentFilter = new IntentFilter(); 
intentFilter.addAction("com.example.broadcasttest .LOCAL_ BROADCAST"); 
localReceiver = new LocalReceiver(); 

localBroadcastManager. registerReceiver(localReceiver, intentFilter); // 注 


册 本 地 广播 监听 器 


@override 
protected void onDestroy() { 
super .onDestroy(); 
localBroadcastManager .unregisterReceiver(localReceiver); 


class LocalReceiver extends BroadcastReceiver { 
@override 
public void onReceive(Context context, Intent intent) { 


Toast.makeText(context, "received local broadcast", Toast.LENGTH_SHORT). 


} 


有 没有 感觉 这 些 代 但 很 朗 共 ? 没 错 ， 其 实 这 基本 上 就 和 我 们 前 面 所 学 的 
动态 注册 广播 接收 器 以 及 发 送 广播 的 代码 是 一 样 的 。 只 不 过 现在 首先 是 
通过 LocalBroadcastManager 的 getInstance() 方 法 得 到 了 它 的 一 个 洋 例 ， 
然后 在 注册 广播 接收 器 的 时 候 调 用 的 是 LocalBroadcastManager 的 
registerReceiver() 方 法 ， 在 发 送 广播 的 时 候 调 用 的 是 
LocalBroadcastManager 的 sendBroadcast() 方 法 ， 仅 此 而 已 。 这 里 我 们 在 
按钮 的 点 击 事件 里 面 发 出 了 一 

条 com.example.broadcasttest .LOCAL_BROADCAST 广 播 ， 然 后 在 
LocalReceiver 里 去 接收 这 条 广播 。 重 新 运行 程序 ， 并 点 击 Send Broadcast 
按钮 ， 效 果 如 图 5.9 所 示 。 





BroadcastTest 







SEND BROADCAST 


Teceiyed local broadcast 





图 5.9 接收 到 本 地 广播 


可 以 看 到 ，LocalReceiver 成 功 接收 到 了 这 条 本 地 广播 ， 并 通过 Toast 提 示 
了 出 来 。 如 果 你 还 有 兴趣 进行 实验 ， 可 以 尝试 在 BroadcastTest2 中 也 去 

接收 com. example.broadcasttest. LOCAL_BROADCAST 这 条 广播 。 答 案 是 显 
We 肯定 无 法 收 到 ， 因 为 这 条 广播 只 会 在 BroadcastTest 程 序 内 传 


另外 还 有 一 点 需要 说 明 ， 本 地 广播 是 无 法 通过 静态 注册 的 方式 来 接收 
的 。 其 实 这 也 完全 可 以 理解 ， 因 为 静态 注册 主要 就 是 为 了 让 程序 在 未 局 
动 的 情况 下 也 能 收 到 广播 ， 而 发 送 本 地 广播 时 ， 我 们 的 程序 肯定 是 已 经 
局 动 了 ， 因 此 也 完全 不 需要 使 用 静态 注册 的 功能 。 


最 后 我 们 再 来 盘点 一 下 使 用 本 地 广播 的 几 点 优势 吧 。 








。 可 以 明确 地 知道 正在 发 送 的 广播 不 会 离开 我 们 的 程序 ， 因 此 不 必 担 
心机 密 数 据 泄漏 。 


。 其 他 的 程序 无 法 将 广播 发 送 到 我 们 程序 的 内 部 ， 因 此 不 需要 担心 会 
有 安全 漏洞 的 隐患 。 


。 发 送 本 地 广播 比 发 送 系统 全 局 广播 将 会 更 加 高 效 。 








5.5 广播 的 最 佳 实践 一 实现 强制 下 


线 功能 


本 章 的 内 容 不 是 非常 多 ， 因 此 相信 你 也 一 定 学 得 很 轻松 吧 。 现 在 我 们 束 
准备 通过 一 个 完整 例子 的 实践 ， 来 综合 运用 一 下 本 章 中 所 学 到 的 知识 。 


强制 下 线 功 能 应 该 算是 比较 稼 见 的 了 ， 很 多 的 应 用 程序 都 具备 这 个 功 

能 ， 比 如 你 的 QQ 号 在 别处 登录 了 ， 束 会 将 你 强制 挤 下 线 。 其 实 实 现 强 
制 下 线 功能 的 思路 也 比较 简单 ， 只 需要 在 界面 上 弹出 一 个 对 话 框 ， 让 用 
户 无 法 进行 任何 其 他 操作 ， 必 须要 点 击 对 话 框 中 的 确定 按钮 ， 然 后 回 到 
登录 界面 即 可 。 可 是 这 样 就 存在 着 一 个 问题 ， 因 为 当 我 们 被 通知 需要 强 
制 下 线 时 可 能 正 处 于 任何 一 个 界面 ， 难 道 需要 在 每 个 界面 上 都 编写 一 个 
弹出 对 话 框 的 逻辑 ? 如 果 你 真 的 这 么 想 ， 那 思维 就 偏远 了 ， 我 们 完全 可 
以 借助 本 章 中 所 学 的 广播 知识 ， 来 非常 轻松 地 实现 这 一 功能 。 新 建 一 个 
BroadcastBestPractice 项 目 ， 然 后 开始 动手 吧 。 


强制 下 线 功 能 需要 先 关 闭 掉 所 有 的 活动 ， 然 后 回 到 登录 界面 。 如 果 你 的 
反应 足够 快 的 话 ， 应 该 会 想到 我 们 在 第 2 章 的 最 佳 实践 部 分 早 就 已 经 实 
现 过 关闭 所 有 活动 的 功能 了 ， 因 此 这 里 只 需要 使 用 同样 的 方案 即 可 。 先 
创建 一 个 Activitycollector 类 用 于 管理 所 有 的 活动 ， 代 码 如 下 所 示 : 


public class ActivityCollector { 




















public static List<Activity> activities = new ArrayList<>(); 


public static void addActivity(Activity activity) { 
activities.add(activity); 


public static void removeActivity(Activity activity) { 
activities.remove(activity); 


然后 创建 BaseActivity 类 作为 所 有 活动 的 父 类 ， 代 码 如 下 所 示 : 


public class BaseActivity extends AppCompatActivity { 


@override 


protected void onCreate(Bundle savedInstanceState) { 


super .onCreate(savedInstanceState); 
ActivityCollector.addActivity(this); 


} 


@Ooverride 


protected void onDestroy() { 
super .onDestroy(); 
ActivityCollector.removeActivity(this); 


以 上 代码 都 是 直接 拿 之 前 写 好 的 内 容 ， 非 常 开心 。 


不 过 从 这 里 开始 ， 


驶 


要 靠 我 们 目 己 去 动手 实现 了 。 首 先 需 要 创建 一 个 登录 界面 的 活动 ， 新 建 


LoginActivity， 并 让 Android Studio 帮 我 们 自动 生成 相应 的 布局 文件 。 
后 编辑 布局 文件 activity_login.xml， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<LinearLayout 


android:orientation="horizontal" 
android:layout_width="match_parent" 
android:layout_height="60dp"> 


<TextView 


android: 


android 
android 


<EditText 


android: 
android: 
android: 
android: 
android: 


</LinearLayout> 


<LinearLayout 


layout_width="90dp" 


:layout_height="wrap_content" 

:layout_gravity="center_vertical" 
android: 
android: 


textSize="18sp" 
text="Account:" /> 


id="@+id/account" 
layout_width="Qdp" 
layout_height="wrap_content" 
layout_ weight="1" 


layout_gravity="center_vertical" /> 


android:orientation="horizontal" 
android:layout_width="match_parent" 
android:layout_height="60dp"> 


<TextView 
android 


android 
android 


<EditText 


android: 
android: 
android: 
android: 
android: 
android: 


</LinearLayout> 


<Button 


:layout_width="90dp" 
android: 


layout_height="wrap_content" 


:layout_gravity="center_vertical" 
:textSize="18sp" 
android: 


text="Password:" /> 


id="@+id/password" 
layout_width="Qdp" 
layout_height="wrap_content" 
layout_ weight="1" 
layout_gravity="center_vertical" 
inputType="textPassword" /> 


android:id="@+id/login" 
android:layout_width="match_parent" 
android:layout_height="60dp" 
android:text="Login" /> 


</LinearLayout> 











然 


4 


这 里 我 们 使 用 LinearLayout 编 写 出 了 一 个 登录 布局 ， 最 外 层 是 一 个 纵 问 
的 LinearLayout， 里 面包 含 了 3 行 直 接 子 元 素 。 第 一 行 是 一 个 横 问 
LinearLayout， 用 于 输入 账号 信息 ; 第 二 行 也 是 一 个 横向 的 





LinearLayout， 用 于 输入 密码 信息 ; 第 三 行 是 一 个 登录 按钮 。 这 个 布局 
文件 里 面 用 到 的 全 部 都 是 我 们 之 前 学 过 的 内 容 ， 相 信和 你 理解 起 来 应 该 不 
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接 下 来 修改 LoginActivity 中 的 代码 ， 如 下 所 示 : 


public class LoginActivity extends BaseActivity { 
private EditText accountEdit; 
private EditText passwordEdit 
private Button login; 


@override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedIinstanceState); 
setContentView(R- layout.activity_ login); 
accountEdit = (EditText) findViewById(R.id.account); 
passwordEdit = (EditText) findvViewById(R. id.password); 
login = (Button) findViewById(R.id.1ogin); 
login.setOoncClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
String account = accountEdit.getText().toSstring(); 
String password = passwordEdit.getText().tostring(); 
// 如 果 账 号 是 admin 且 密码 是 123456， 就 认为 登录 成 功 
if (account . equals( "admin" ) && password.equals("123456")) { 
Intent intent = new Intent(LoginActivity.this, MainActivity. 


s); 
A A 


finish( 

} else { 
Toast. ee this, "account or password is 

invalid", Toast.LENGTH_SHORT). show( ); 
} 
} 
}); 
} 


这 里 我 们 模拟 了 一 个 非常 简单 的 登录 功能 。 首 先 要 将 LoginActivity 的 继 

承 5 构 改 成 继承 目 BaseActivity， 然后 调用 findviewById() 方 法 分 别 获 取 
到 账号 输入 框 、 密 码 输入 框 以 及 登录 按钮 的 实例 。 接 着 在 登录 按钮 的 点 
击 事件 里 面 对 输 入 的 账号 和 密码 进行 判断 ， 如 果 账 号 是 admin 并 且 密 码 
是 123456， 就 认为 登录 成 功 并 跳 转 到 MainActivity， 否 则 就 提示 用 户 账 
号 或 密码 错误 。 


因此 ， 你 束 可 以 将 MainActivity 理 解 成 是 登录 成 功 后 进入 的 程序 主 界面 
了 ， 这 里 我 们 并 不 需要 在 主 界面 里 提供 什么 花哨 的 功能 ， 只 需要 加 入 强 
制 下 线 功 能 就 可 以 了 ， 修 改 activity_main.xzml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 





<Button 
android:id="@+id/force_offline" 
android:layout_width="match_parent" 
android:layout_height="wrap_content 
android:text="Send force offline broadcast" /> 


</LinearLayout> 


非常 简单 ， 只 有 一 个 按钮 而 已 ， 用 于 触发 强制 下 线 功 能 。 然 后 修改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends BaseActivity { 


@override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity main); 
Button forceoffline = (Button) findViewById(R.id.force _ offline); 
forceOoffline.setOonclickListener(new View.OnClickListener() { 
@override 
public void onClick(View v) { 
Intent intent = new Intent("com.example.broadcastbestpractice. 
FORCE_OFFLINE"); 
sendBroadcast (intent); 





同样 非常 简单 ， 不 过 这 里 有 个 重点 ， 我 们 在 按钮 的 点 击 事件 里 面 发 送 了 
一 条 广播 ， 广 播 的 值 

为 com.example.broadcastbestpractice.FORCE_OFFLINE， 这 条 广播 就 是 

用 于 通知 程序 强制 用 户 下 线 的 。 也 就 是 说 强制 用 户 下 线 的 逻辑 并 不 是 写 

在 MainActivity 里 的 ， 而 是 应 该 写 在 接收 这 条 广播 的 广播 接收 器 里 面 ， 

这 样 强 制 下 线 的 功能 就 不 会 依附 于 任何 的 界面 ， 不 管 是 在 程序 的 任何 地 

方 ， 只 需要 发 出 这 样 一 条 广播 ， 就 可 以 完成 强制 下 线 的 操作 了 。 


那么 至 无 疑问 ， 接 下 来 我 们 就 需要 创建 一 个 广播 接收 堪 来 接收 这 条 强制 
下 线 广播 ， 唯 一 的 问题 就 是 ， 应 该 在 哪里 创建 呢 ? 由 于 广播 接收 器 里 面 
需要 弹出 一 个 对 话 框 来 阻塞 用 户 的 正常 操作 ， 但 如 果 创 建 的 是 一 个 静态 
注册 的 广播 接收 器 ， 是 没有 办 法 在 onReceive( ) 方 法 里 弹出 对 话 框 这 样 

0 而 我 们 显然 也 不 可 能 在 每 个 活动 中 都 去 注册 一 个 动态 的 三 


那么 到 底 应 该 怎么 办 呢 ? 答案 其 实 很 明显 ， 只 需要 在 BaseActivity 中 动 


态 注册 一 个 广播 接收 喜 就 可 以 了 ， 因 为 所 有 的 活动 都 是 继承 自 
BaseActivity 的 。 


修改 BaseActivity 中 的 代码 ， 如 下 所 示 : 


public class BaseActivity extends AppCompatActivity { 
































private ForceOofflineReceiver receiver; 


@override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceSstate); 
ActivityCollector.addActivity(this); 

} 


@override 
protected void onResume() { 


Super .onResume( ); 

IntentFilter intentFilter = new IntentFilter(); 
intentFilter.addAction("com.example.broadcastbestpractice.FORCE_OFFLINE"); 
receiver = new ForceOfflineReceiver(); 

registerReceiver(receiver, intentFilter); 


} 


@override 
protected void onPause() { 
super .onPause(); 
if (receiver != null) { 
tel oat 
receiver = nul 
} 
} 


@Ooverride 

protected void onDestroy() { 
super .onDestroy(); 
ActivityCollector.removeActivity(this); 


} 
class ForceOfflineReceiver extends BroadcastReceiver { 


@override 
public void onReceive(final Context context, Intent intent) 
AlertDialog.Builder builder = new AlertDialog.Builder(context); 
builder.setTitle("Warning"); 
builder.setMessage("You are forced to be offline. Please try to login 
again."); 
builder .setCancelable(false); 
builder.setPositiveButton("OK", new DialogInterface.OnClickListener() { 
@Ooverride 
public void onClick(DialogInterface dialog, int which) { 
ActivityCollector， finishAl1(); // 销毁 所 有 活动 
Intent intent = new a LoginActivity.class); 
context.startActivity(intent); // 重新 启动 LoginActivity 


}); 
builder .show(); 





先 来 看 一 下 ForceOfflineReceiver 中 的 代码 ， 这 次 onReceive() 方 法 里 可 不 
再 是 仅仅 弹出 一 个 Toast 了 ， 而 是 加 入 了 较 多 的 代码 ， 那 我 们 就 来 仔细 
地 看 看 吧 。 首 先 肯定 是 使 用 Alertpialog.Builder 来 构建 一 个 对 话 框 ， 注 
意 这 里 一 定 要 调用 setcancelable() 方 法 将 对 话 框 设 为 不 可 取消 ， 人 否则 用 
户 按 一 下 Back 键 就 可 以 关闭 对 话 框 继续 使 用 程序 了 。 人 然后 使 

用 setPositiveButton() 方 法 来 给 对 话 框 注册 确定 按钮 ， 当 用 户 乓 点 击 了 确 
定 按钮 时 ， 就 调用 ActivityCollector 的 finishAl1() 方 法 来 销 皇 肌 掉 所 有 活 
动 ， 并 重新 启动 LoginActivity 这 个 活动 。 


再 来 看 一 下 我 们 是 怎么 注册 ForceOfflineReceiver 这 个 广播 接收 器 的 ， 可 
以 看 到 ， 这 里 重 写 了 onResume() 和 onPause() 这 两 个 生命 周期 函数 ， 然 后 
分 别 在 这 两 个 方法 里 注册 和 取消 注册 了 ForceOfflineReceiver。 


那么 为 什么 要 这 样 写 呢 ? 之 前 不 都 是 在 oncreate() 和 onpestroy() 方 法 里 
来 注册 和 取消 注册 广播 接收 器 的 么 ? 这 是 因为 我 们 始终 需要 保证 只 有 处 
于 栈 顶 的 活动 才能 接收 到 这 条 强制 下 线 广播 ， 非 栈 顶 的 活动 不 应 该 也 没 
有 必要 去 接收 这 条 广播 ， 所 以 写 在 onResume() 和 onPause() 方 法 里 就 可 以 
很 好 地 解决 这 个 问题 ， 当 一 个 活动 失去 栈 顶 位 置 时 融会 自动 取消 广播 接 





收费 的 注册 。 


这 样 的 话 ， 所 有 强制 下 线 的 逻辑 就 已 经 完成 了 ， 接 下 来 我 们 还 需要 对 
AndroidManifest.xml 文 件 进行 修改 ， 代 码 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcastbestpractice"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<activity android:name=" .MainActivity"> 
</activity> 
<activity android:name=" .LoginActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 


</manifest> 





这 里 只 需要 对 一 处 代码 进行 修改 ， 就 古 将 主 活动 设置 为 LoginActivity 而 
不 再 是 MainActivity， 因 为 你 上 月 定 不 希望 用 户 在 没 登 录 的 情况 下 束 能 直 
接 进入 到 程序 主 界面 吧 ? 


好 了 ， 现 在 来 尝试 运行 一 下 程序 吧 ， 首 先 会 进入 到 登录 界面 ， 并 可 以 在 
这 里 输入 账号 和 密码 ， 如 图 5.10 所 示 。 





BroadcastBestPractice 


Account: admin 








图 5.10 登录 界面 


如 果 输 入 的 账号 是 admin， 密 码 是 123456， 点 击 登 录 按钮 就 会 进入 到 程 
序 的 主 界面 ， 如 图 5.11 所 示 。 这 时 点 击 一 下 发 送 广播 的 按钮 ， 就 会 发 出 
一 条 强制 下 线 的 广播 ，ForceOfflineReceiver 里 收 到 这 条 广播 后 会 弹出 一 
个 对 话 框 提示 用 户 已 被 强制 下 线 ， 如 图 5.12 所 示 。 





wa B 11:42 


BroadcastBestPractice 


SEND FORCE OFFLINE BROADCAST 








图 5.11 主 界面 


Warning 


You are forced to be offline. Please try to 
login again 


OK 





图 5.12 强制 下 线 提示 


这 时 用 户 将 无 法 再 对 界面 的 任何 元 系 进 行 操作 ， 只 能 点 击 确定 按钮 ， 然 
后 会 重新 回 到 登录 界面 。 这 样 ， 强 制 下 线 功能 就 已 经 完整 地 实现 了 。 


结束 了 本 章 的 最 佳 实践 部 分 ， 接 下 来 我 们 要 进入 一 个 特殊 的 环节 。 相 信 
你 一 定 也 知道 ， 几 乎 所 有 出 色 的 项 目 都 不 会 是 由 一 个 人 单枪匹马 完成 

的 ， 而 古 由 一 个 团队 共同 合作 开发 完成 的 。 这 个 时 候 多 人 之 间 代 码 同步 
的 问题 就 亚 得 腊 负 重要， 因此 版 本 控制 工具 也 就 应 运 而 生 了 。 第 见 的 版 
本 控制 工具 主要 有 svn 和 Git， 本 书 中 将 会 对 Git 的 使 用 方法 进行 全 面 的 讲 
解 ， 并 且 讲 解 的 内 容 是 穿插 于 一 些 革 节 当 中 的 。 那 么 今天 ， 我 们 束 先 来 
看 一 看 关于 Git 最 基本 的 用 法 。 

















5.6 Git 时间 一 一 初 识 版 本 控制 工具 


Git 是 一 个 开源 的 分 布 式 版 本 控制 工具 ， 它 的 开发 者 束 是 蜀 电 大 名 的 
Linux 操 作 系 统 的 作者 Linus Torvalds。Git 被 开发 出 来 的 初衷 是 为 了 更 好 
地 管理 Linux 内 核 ， 而 现在 却 早已 被 广泛 应 用 于 全 球 各 种 大 中 小 型 的 项 
目 中 。 今 天 是 我 们 关于 Git 的 第 一 堂 课 ， 主 要 是 讲解 一 下 它 最 基本 的 用 
法 ， 那 么 就 从 安装 Git 开 始 吧 。 


5.6.1 ”安装 Git 
由 于 Git 和 Linux 操 作 系 统 都 是 同一 个 作者 ， 因 此 不 用 我 说 ， 你 也 应 该 猜 


到 Git 在 Linux 上 的 安装 是 最 简单 方便 的 。 比 如 你 使 用 的 是 Ubuntu 系 统 ， 
只 需要 打开 shell 界 面 ， 并 输入 : 


sudo apt-get install git-core 








按 下 回 车 后 输入 密码 ， 即 可 完成 Git 的 安装 。 


不 过 我 相信 你 更 有 可 能 使 用 的 还 是 Windows 操 作 系 统 ， 因 此 本 小 节 的 重 
点 是 教会 你 如 何在 Windows 上 安装 Git。 不 同 于 Linux，Windows 上 可 无 
法 通过 一 行 命令 束 完 成 安装 了 ， 我 们 需要 先 把 Git 的 安装 包 下 载 下 来 。 
访问 网 址 https://git-for-windows.github.io/， 可 以 看 到 如 图 5.13 所 示 的 页 
面 。 


" 
git for windows FAQ 









We bring the 
awesome Git SCM to 
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图 5.13 git for windows 主 页 


目前 最 新 的 git for windows 版 本 是 2.8.1， 我 就 准备 使 用 这 一 版 本 了 ， 如 
果 你 下 载 的 时 候 发 现 又 有 新 的 版 本 ， 可 以 尝试 一 下 最 新 版 本 的 Git。 点 
击 Download 按 钮 可 以 开始 下 载 ， 下 载 完 成 后 双击 安装 包 进 行 安 装 ， 之 后 
- 直 点 击 “ 下 一 步 ” 就 可 以 完成 安装 了 。 


5.6.2 ”创建 代码 仓库 


里 然 在 Windows 上 安装 的 Git 是 可 以 在 图 形 界面 上 进行 操作 的 ， 并 且 
Android Studio 也 支持 以 图 形 化 的 形式 操作 Git， 但 是 这 里 我 并 不 建议 你 
这 样 做 ， 因 为 Git 的 各 种 命令 才 是 你 应 该 掌握 的 核心 技能 ， 不 管 你 是 在 
哪个 操作 系统 中 ， 使 用 命令 来 操作 Git 肯 定 都 是 通用 的 。 而 图 形 化 的 操 
0 进一步 提升 你 工作 效率 的 


那么 我 们 现在 就 来 尝试 一 下 如 何 通 过 命令 来 使 用 Git。 如 果 你 使 用 的 是 
Linux 系 统 ， 就 先 打开 shell 界 面 ， 如 果 使 用 的 是 Windows 系 统 ， 就 从 开始 
里 找到 Git Bash 并 打开 。 


首先 应 该 配置 一 下 你 的 映 份 ， 这 样 在 提交 代码 的 时 候 Git 就 可 以 知道 是 
谁 提 交 的 了 ， 命 令 如 下 所 示 : 











配置 完成 后 你 还 可 以 使 用 同样 的 命令 来 查看 是 否 配置 成 功 ， 只 需要 将 最 
后 的 名 字 和 邮箱 地 址 去 掉 即 可 ， 如 图 5.14 所 示 。 





$ git config --global user.name 
Tony 


$ git config --global user.email 
tony@gma1 | . com 





图 5.14 查看 git 用 户 名 和 邮箱 


然后 我 们 束 可 以 开始 创建 代码 仓库 了 ， 仓 库 (Repository〉 是 用 于 保存 
版 本 管理 所 需 信息 的 地 方 ， 所 有 本 地 提交 的 代码 都 会 被 提交 到 代码 仓库 
中 ， 如 果 有 需要 还 可 以 再 推送 到 远程 仓库 中 。 


这 里 我 们 尝试 着 给 BroadcastBestPractice 项 目 建立 一 个 代码 仓库 。 先 进入 
到 BroadcastBestPractice 项 目的 目录 下 面 ， 如 图 5.15 所 示 。 











Users/Administrator/AndroidstudioProjects/BroadcastBestPractice 





图 5.15 切换 到 BroadcastBestPractice 项 目 目 录 下 


然后 在 这 个 目录 下 面 输入 如 下 命令 : 


git init 


很 简单 吧 ! 只 需要 一 行 命令 就 可 以 完成 创建 代码 仓库 的 操作 ， 如 图 5.16 
所 示 。 


$ git 1n71t 


Initialized empty Git repository in C:/Users/Administrator/AndroidstudioProjects 
BroadcastBestPractice/.git/ 





图 5.16 创建 代码 仓库 


仓库 创建 完成 后 ， 会 在 BroadcastBestPractice 项 目的 根 目 录 下 生成 一 个 隐 
藏 的 .git 文 件 夹 ， 这 个 文件 夹 就 是 用 来 记录 本 地 所 有 的 Git 操 作 的 ， 可 以 
通过 1s -al 命令 来 查看 一 下 ， 如 图 5.17 所 示 。 











BroadcastBestPractice. 1m] 


1 Administrator 7A 和 。 build.gradle 
Admin1istrator 2 


.broperties 


w. bat 
DCal. Propert1es 
settings.gradle 





图 5.17 查看 .git 文 件 

如 末 你 想 要 删除 本 地 仓库 ， 只 需要 删除 这 个 文件 夹 就 行 了 。 

5.6.3 ”提交 本 地 代码 

代码 仓库 建立 完 之 后 就 可 以 提交 代码 了 ， 其 实 提交 代码 的 方法 也 非常 简 
单 ， 只 需要 使 用 add 和 commit 命 令 就 可 以 了 。add 用 于 把 想 要 提交 的 代码 


先 添加 进来 ， 而 commit 则 是 真正 地 去 执行 提交 操作 。 比 如 我 们 想 添 加 
build.gradle 文 件 ， 就 可 以 输入 如 下 命令 : 


git add build.gradle 











这 是 添加 单个 文件 的 方法 ， 那 如 果 我 们 想 添 加 某 个 目录 呢 ? 其 实 只 需要 
在 add 后 面 加 上 目录 名 就 可 以 了 。 比 如 将 整个 app 目 录 下 的 所 有 文件 都 进 
行 添加 ， 就 可 以 输入 如 下 命令 : 


git add app 











可 是 这 样 一 个 个 地 添加 感觉 还 是 有 些 复 杀 ， 有 没有 什么 办 法 可 以 一 次 性 
就 把 所 有 的 文件 都 添加 好 呢 ? 当然 可 以 ， 只 需要 在 add 的 后 面 加 上 一 个 
尽 ， 束 表示 添加 所 有 的 文件 了 ， 命 令 如 下 所 示 : 


git add . 





现在 BroadcastBestPractice 项 目下 所 有 的 文件 都 已 经 添加 好 了 ， 我 们 可 以 
来 提交 一 下 了 ， 输 入 如 下 命令 : 


git commit -m "First commit." 


注意 ， 在 commit 命 令 的 后 面 ， 我 们 一 定 要 通过 -m 参 数 来 加 上 提交 的 描述 
言 轧 ， 没 有 描述 信息 的 提交 被 认为 是 不 合法 的 。 这 样 所 有 的 代码 就 已 经 
成 功 提交 了 ! 


好 了 ， 关 于 Git 的 内 容 ， 今 天 我 们 就 学 到 这 里 ， 虽 然 内 容 并 不 多 ， 但 是 
你 已 经 将 Git 最 基本 的 用 法 都 掌握 了 ， 不 是 吗 ? 在 本 书后 面 的 章节 ， 还 
会 军 插 一 些 Git 的 讲解 ， 到 时 候 你 将 学 会 更 多 关于 Git 的 使 用 技巧 ， 现 在 
就 让 我 们 来 总 结 一 下 吧 。 








5.7 “小结 与 点 评 


本 章 中 我 们 主要 是 对 Android 的 广播 机 制 进行 了 深入 的 研究 ， 不 仅 了 解 
了 广播 的 理论 知识 ， 还 掌握 了 接收 广播 、 发 送 目 定 义 广 播 以 及 本 地 广播 
的 使 用 方法 。 广 播 接 收 器 属于 Android 四 大 组 件 之 一 ， 在 不 知 不 觉 中 你 
已 经 掌握 了 四 大 组 件 中 的 两 个 了 。 


在 最 佳 实践 环节 中 你 一 定 也 收获 了 不 少 ， 不 仅 运 用 到 了 本 章 所 学 的 广播 
知识 ， 还 将 前 面 章 节 所 学 到 的 技巧 综合 运用 到 了 一 起 。 经 过 这 个 例子 之 
后 ， 相 信 你 对 所 涉及 的 每 个 知识 点 都 有 了 更 深 一 层 的 认识 。 另 外 ， 本 章 
还 添加 了 一 个 最 最 特殊 的 环节 ， 即 Git 时 间 。 在 这 个 环节 中 ， 我 们 对 Git 
这 个 版 本 控制 工具 进行 了 初步 的 学 习 ， 后 面 还 会 学 习 关 于 它 的 更 多 内 

全 


下 一 章 我 们 本 应 该 继续 学 习 Android 四 大 组 件 中 的 内 容 提供 器 ， 不 过 由 


于 学 习 内 容 提 供 器 之 前 需要 先 掌 握 Android 中 的 持久 化 技术 ， 因 此 下 一 
章 我 们 就 先 对 这 一 主题 展开 讨论 。 














第 6 草 数据 存储 全 方案 一 详解 持 
信 化 技术 


任何 一 个 应 用 程序 ， 其 实说 白 了 就 是 在 不 停 地 和 数据 打交道 ， 我 们 聊 
QQ、 看 新 闻 、 刷 微 博 ， 所 关心 的 都 是 里 面 的 数据 ， 没 有 数据 的 应 用 程 
序 就 变 成 了 一 个 空 序 子 ， 对 用 户 来 说 没有 任何 实际 用 途 。 那 么 这 些 数据 
都 是 从 哪 来 的 呢 ? 现在 多 数 的 数据 基本 都 是 由 用 户 产生 的 ， 比 如 你 发 微 
博 、 评 论 新 闻 ， 其 实 都 是 在 产生 数据 。 


而 我 们 前 面 章 节 所 编写 的 众多 例子 中 也 有 用 到 各 种 各 样 的 数据 ， 例 如 第 
3 章 最 佳 实践 部 分 在 聊天 界面 编写 的 聊天 内 容 ， 第 5 章 最 佳 实践 部 分 在 登 
录 界 面 输入 的 账号 和 密码。 这 些 数据 都 有 一 个 共同 点 ， 即 它们 都 属于 瞬 
时 数据 。 那 么 什么 是 瞬时 数据 呢 ? 就 是 指 那些 存储 在 内 存 当 中 ， 有 可 能 
会 因为 程序 关闭 或 其 他 原因 导致 内 存 被 回收 而 丢失 的 数据 。 这 对 于 一 些 
关键 性 的 数据 信息 来 说 是 绝对 不 能 容忍 的 ， 谁 都 不 硕 望 目 己 刚 发 出 去 的 
一 条 微 博 ， 刷 新 一 下 惑 没 了 吧 。 那 么 怎样 才能 保证 一 些 关 键 性 的 数据 不 
会 丢失 呢 ? 这 束 需 要 用 到 数据 持久 化 技术 了 。 





























6.1 持久 化 技术 何人 


数据 持久 化 就 是 指 将 那些 内 存 中 的 瞬时 数据 保存 到 存储 设备 中 ， 保 证 即 
使 在 手机 或 电脑 关机 的 情况 下 ， 这 些 数据 仍然 不 会 丢失 。 保 存在 内 存 中 
的 数据 是 处 于 瞬时 状态 的 ， 而 保存 在 存储 设备 中 的 数据 是 处 于 持久 状态 
的 2 了 一 种 机 制 可 以 让 数据 在 瞬时 状态 和 持久 状态 之 
间 进 行 转换 。 


持久 化 技术 被 广泛 应 用 于 各 种 程序 设计 的 领域 当中 ， 而 本 书 中 要 探讨 的 
自然 是 Android 中 的 数据 持久 化 技术 。Android 系 统 中 主要 提供 了 3 种 方式 
用 于 简单 地 实现 数据 持久 化 功能 ， 即 文件 存储 、SharedPreferences 存 储 

以 及 数据 库存 储 。 当 然 ， 除 了 这 3 种 方式 之 外 ， 你 还 可 以 将 数据 保存 在 

手机 的 SD 卡 中 ， 不 过 使 用 文件 、SharedPreferences 或 数据 库 来 保存 数据 
会 相对 更 简单 一 些 ， 而 且 比 起 将 数据 保存 在 SD 卡 中 会 更 加 地 安全 。 


那么 下 面 我 束 将 对 这 3 种 数据 持久 化 的 方式 一 一 进行 详细 的 讲解 。 











6.2 ”文件 存储 


文件 存储 是 Android 中 最 基本 的 一 种 数据 存储 方式 ， 它 不 对 存储 的 内 容 
进行 任何 的 格式 化 处 理 ， 所 有 数据 都 是 原封 不 动 地 保存 到 文件 当中 的 ， 
因而 它 比 较 适 合用 于 存储 一 些 简单 的 文本 数据 或 二 进 制 数据 。 如 果 你 想 
使 用 文件 存储 的 方式 来 保存 一 些 较为 复杂 的 文本 数据 ， 就 需要 定义 一 套 
目 己 的 格式 规范 ， 这 样 可 以 方便 之 后 将 数据 从 文件 中 重新 解析 出 来 。 


那么 首先 我 们 就 来 看 一 看 ，Android 中 是 如 何 通过 文件 来 保存 数据 的 。 
6.2.1 将 数据 存储 到 文件 中 


context 类 中 提供 了 一 个 openFileoutput() 方 法 ， 可 以 用 于 将 数据 存储 到 
指定 的 文件 中 。 这 个 方法 接收 两 个 参数 ， 第 一 个 参数 是 文件 名 ， 在 文件 
创建 的 时 候 使 用 的 就 是 这 个 名 称 ， 注 意 这 里 指定 的 文件 名 不 可 以 包含 路 
径 ， 因 为 所 有 的 文件 都 是 默认 存储 到 /data/data/<package name>/files/ 目 
录 下 的 。 第 二 个 参数 是 文件 的 操作 模式 ， 主 要 有 两 种 模式 可 选 ， 
MODE_PRIVATE 和 MODE_APPEND。 其 中 MODE_PRIVATE 是 默认 的 
操作 模式 ， 表 示 当 指定 同样 文件 名 的 时 候 ， 所 写 入 的 内 容 将 会 覆盖 原文 
件 中 的 内 容 ， 而 MODE_APPEND 则 表示 如 果 该 文件 已 存在 ， 就 往 文件 
里 面 追 加 内 容 ， 不 存在 就 创建 新 文件 。 其 实 文 件 的 操作 模式 本 来 还 有 男 
外 两 种 : MODE_WORLD_READABLE 和 
MODE_WORLD_WRITEABLE， 这 两 种 模式 表示 人 允许 其 他 的 应 用 程序 
对 我 们 程序 中 的 文件 进行 读 写 操作 ， 不 过 由 于 这 两 种 模式 过 于 危险 ， 很 
容易 引起 应 用 的 安全 性 漏洞 ， 已 在 Android 4.2 版 本 中 被 废弃 


openFileoutput () 方 法 返回 的 是 一 个 FileoutputStream 对 象 ， 得 到 了 这 
个 对 象 之 后 就 可 以 使 用 Java 流 的 方式 将 数据 写 入 到 文件 中 了 。 以 下 是 一 
段 简 单 的 代码 示例 ， 展 示 了 如 何 将 一 段 文 本 内 容 保 存 到 文件 中 : 


public void save() 





























out = openFileOutput("data", Context .MODE re) 
it =n Bufferedwriter(new OutputStr er(out )) 


} 
} catch (IOException e) { 
e.printstackTrace(); 
} 
} 
} 


如 果 你 已 经 比较 熟悉 Java 流 了， 理解 上 面 的 代码 一 定 轻而易举 吧 。 这 里 
通过 openFileoutput() 方 法 能 够 得 到 一 个 FileoutputSstream 对 象 ， 然 后 
再 借助 它 构 建 出 一 个 outputstreamwriter 对 象 ， 接 着 再 使 

用 0utputstreamwriter 构 建 出 一 个 Bufferedwriter 对 象 ， 这 样 你 就 可 以 
通过 Bufferedwriter 来 将 文本 内 容 写 入 到 文件 中 了 。 


下 面 我 们 就 编写 一 个 完整 的 例子 ， 借 此 学 习 一 下 如 何在 Android 项 目 中 
使 用 文件 存储 的 技术 。 首 先 创 建 一 个 FilePersistenceTest 项 目 ， 并 修改 
activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 





<EditText 
android:id="@+id/edit" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:hint="Type something here" 
/> 


</LinearLayout> 


这 里 只 是 在 布局 中 加 入 了 一 个 EditText， 用 于 输入 文本 内 容 。 其 实现 在 
你 就 可 以 运行 一 下 程序 了 ， 界 面 上 肯定 会 有 一 个 文本 输入 框 。 然 后 在 文 
本 输入 框 中 随意 输入 点 什么 内 容 ， 再 按 下 Back 键 ， 这 时 输入 的 内 容 肯 定 
就 已 经 丢失 了 ， 因 为 它 只 是 瞬时 数据 ， 在 活动 被 销毁 后 就 会 被 回收 。 而 
这 里 我 们 要 做 的 ， 残 是 在 数据 锐 回 收 之 前 ， 将 它 存 储 到 文件 当中 。 修 改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 











private EditText edit; 


@override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity main); 
edit = (EditText) findViewById(R.id.edit); 


@override 

protected void onDestroy() { 
super .onDestroy( ) 
String inputText = edit.getText().tostring(); 
Save(inputText ) 


public void save(String inputText) { 
FileOutputStream out = null; 
Bufferedwriter writer = null; 
try { 
out = openFileOutput("data", Context .MODE_ PRIVATE); 


wri ee = new Bufferedwriter(new OutputStreamwriter(out)); 
i rite(inpu De Xt ) > 
} eate h 《IOEx ception e) { 
e.printstackTrace(); 
} finally { 
try 
if (writer != null) { 
writer.close(); 


} 
} Ce 由 ee xception e) { 
ntstackTrace(); 
} 


+ 
} 


可 以 看 到 ， 首先 我 们 在 oncreate() 方 法 中 获取 了 EditText 的 实例 ， 然后 

重 写 了 onDestroy() 方 法 ， 这 样 束 可 以 保证 在 活动 销毁 之 前 一 定 会 调用 

这 个 方法 。 在 onDestroy() 方 法 中 我 们 获取 了 EditText 中 输入 的 内 容 ， 并 
调用 save() 方 法 把 输入 的 内 容 存储 到 文件 中 ， 文 件 命名 为 data。 save() 

方法 中 的 代码 和 之 前 的 示例 基本 相同 ， 这 里 束 不 再 做 解释 了 。 现 在 重新 
运行 一 下 程序 ， 并 在 EditText 中 输入 一 些 内 容 ， 如 图 6.1 所 示 。 
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FilePersistenceTest 


Content 








图 6.1 在 EditText 中 随意 输入 点 内 容 


然后 按 下 Back 键 关闭 程序 ， 这 时 我 们 输入 的 内 容 束 已 经 保存 到 文件 中 

了 了。 那么 如 何 才 能 证 实数 据 确实 已 经 保存 成 功 了 了 呢 ? 我 们 可 以 借助 
Android Device Monitor 工 具 来 查看 一 下 。 点 击 Android Studio 导 航 栏 中 的 
Tools ~“ Android， 会 看 到 如 图 6.2 所 示 的 工具 列表 。 





吾 Sync project with Gradle Files 
忌 ， Android Device Monitor 

[有 AVD Manager 

.SDK Manager 

V Enable ADB Integration 

号 Layout Inspector 

() Theme Editor 

QQ Google App Indexing Test 


图 6.2 ” Android 工具 列表 


点 击 Android Device Monitor 就 可 以 打开 Android Device Monitor 工 具 了 ， 
然后 进入 File Explorer 标 签 页 ， 在 这 里 找 
到 /data/data/com.example.filepersistencetestfiles/ 目 录 ， 可 以 看 到 生成 了 
一 个 data 文 件 ， 如 图 6.3 所 示 。 〈 注 : Android 7.0 系 统 的 模拟 器 可 能 无 法 
正常 查看 File Explorer 中 的 内 容 ， 这 或 许 是 新 版 模拟 器 的 一 个 bug， 可 能 
会 在 未 来 的 版 本 中 修复 。 如 果 你 过 到 了 这 种 情况 ， 创 建 一 个 Android 6.0 
系统 的 模拟 器 即 可 解决 。) 











总 Threads | 目 Heap | 目 Allocation Tr.. 全 Network Stat... Eb File Explorer 负 @ Emulator Co.., | 口 System Infor.| a0 








Name 


图 6. 
然后 点 





阶 自 | 一直” 
Size Date Time Permissions Info 全 
by BG com.example.broadcastbestpract! 2016-04-16 09;46 drwxr-x--x 
b GB com.example,broadcasttest 2016-04-16 03:40 drwxr-x--x 
b BG com.example,broadcasttest2 2016-04-16 07:51 drwxr-x--x 
4 区 com.example.filepersistencetest 2016-04-24 11:18 drwxr-x--x 
» EE cache 2016-04-24 11:18 drwxrwx--x 
b GB code_cache 2016-04-24 11:18 drwxrwx--x 
4 GG flles 2016-04-24 11:24 drwx----- 
data 7 2016-04-24 11:24 -rw-rw-- 
b GS instant-run 2016-04-24 11:18 drwx------ = 
》 允 com.example.fragmentbestpractic 2016-04-10 08:50 drwxr-x--x 
b BE com.example.fragmenttest 2016-04-09 15:20 drwxr-x--x 
» GB com.example.listviewtest 2016-04-01 12:26 drwxr-x--x 
多 com.example.recyclerviewtest 2016-04-02 11:47 drwxr-x--x 
» GB com.example.uibestpractice 2016-04-04 08:13 drwxr-x--x 
b EB com.example.uicustomviews 2016-03-28 14:14 drwxr-x--x 
by BB com.example.uilayouttest 2016-03-27 12:01 drwxr-x--x w 
3 生成 的 data 文 件 
点 击 图 6.4 中 左边 的 按钮 可 以 将 这 个 文件 导出 到 电脑 上 。 


图 6.4 导入 导出 按钮 
使 用 记事 本 打开 这 个 文件 ， 里 面 的 内 容 如 图 6.5 所 示 。 


文件 (PF) ”编辑 (E) 格式 (QO) ” 章 春 (V) “帮助 (H) 





Content 








图 6.5 data 文 件 中 的 内 容 
这 样 就 证 实 了 ， 在 EditText 中 输入 的 内 容 确 实 已 经 成 功 保存 到 文件 中 
下 











不 过 只 是 成 功 将 数据 保存 下 来 还 不 够 ， 我 们 还 需要 想 办 法 在 下 次 月 动 程 
序 的 时 候 让 这 些 数据 能 够 还 原 到 EditText 中 ， 因 此 接 下 来 我 们 就 要 学 习 
一 下 如 何 从 文件 中 读 取 数据 。 


6.2.2 ”从 文件 中 读 取 数据 


类 似 于 将 数据 存储 到 文件 中 ，context 类 中 还 提供 了 一 

个 openFileInput() 方 法 ， 用 于 从 文件 中 读 取 数据 。 这 个 方法 要 比 
openFileoutput() 简 单一 些 ， 它 只 接收 一 个 参数 ， 即 要 读 取 的 文件 名 ， 
然后 系统 会 自动 到 /data/data/<package “name>/files/ 目 录 下 去 加 载 这 个 文 
件 ， 并 返回 一 个 FileInputstream 对 象 ， 得 到 了 这 个 对 象 之 后 再 通过 Java 
流 的 方式 就 可 以 将 数据 读 取 出 来 了 。 


以 下 是 一 段 简单 的 代码 示例 ， 展 示 了 如 何 从 文件 中 读 取 文 本 数据 : 


public St noe loa a i 
FileInputStre 名 
Bu fe ar der edd = null; 
St noe ilder conten E = new StringBuilder(); 
try 全 





ope nFile a pps tC ‘data"); 
new edReader (new InputStreamReader (in)); 


Fing = 
Ws CA eadLine()) != null) { 
nt appe ds ine e); 


} catch (IOException e) { 
e.printSstackTrace(); 
a. 


cl ); 
} coi 2 (Togxe eption e) { 
ackTrace(); 
} 


eturn content.toSstring(); 


在 这 段 代码 中 ， 首 先 通 过 openFileInput() 方 法 获取 到 了 一 

个 FileInputstream 对 象 ， 然 后 借助 它 叉 构建 出 了 一 

个 InputSstreamReader 对 象 ， 接 着 再 使 用 InputstreamReader 构 建 出 一 
个 BufferedReader 对 象 ， 这 样 我 们 就 可 以 通过 BufferedReader 进 行 一 行 
行 地 读 取 ， 把 文件 中 所 有 的 文本 内 容 全 部 读 取出 来 ， 并 存放 在 一 

个 stringBuilder 对 象 中 ， 最 后 将 读 取 到 的 内 容 返 回 就 可 以 了 。 








了 解 了 从 文件 中 读 取 数据 的 方法 ， 那 么 我 们 就 来 继续 完善 上 一 小 节 中 的 
例子 ， 使 得 重新 启动 程序 时 EditText 中 能 够 保留 0 
修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 





private EditText edit; 


@override 
protected void onCreate(Bundle SavedInstanceState) { 

Super .oncCreate(SavedInstanceState) 

setcontentVicew(R;: layout.activity_main); 

edit = (EditText) ngewe YTd CR id.edit); 

String inputText = load(); 

if (!TextUtils.isEmpty(inputText)) { 

edit.setText(inputText); 

edit. setSelection(inputText. length()); 
Toast.makeText(this, "Restoring succeeded", Toast.LENGTH_SHORT).show(); 
} 
} 


public String load() = 

FileInputStream in = null; 

BufferedReader reader = nul1; 

StringBuilder content = new StringBuilder(); 

try { 
in = openFileInput("data 
reader = new Bu deredReadefnew InputStreamReader (in)); 
String line = "" 
while ((line = reader.readLine()) != null) { 

content.append(line); 


} 
} catch (IOException e) { 
e.printstackTrace(); 
} finally { 
if (reader != null) { 
try { 
reader .close(); 
} catch (IOException e) { 
e.printStackTrace(); 
~} 
} 


return content.tostring(); 


可 以 看 到 ， 这 里 的 思路 非常 简单 ， 在 oncreate() 方 法 中 调用 load() 方 法 
来 读 取 文件 中 存储 的 文本 内 容 ， 如 果 读 到 的 内 容 不 为 nul1， 就 调用 
EditText 的 setText() 方 法 将 内 容 填充 到 EditText 里 ， 并 调 
ee 实 输 

然后 弹出 一 句 还 原 成 功 的 提示 。1oad() 方 法 中 的 细节 我 们 在 前 面 已 
从 济 过 ， 这 里 就 不 再 交还 了， 








注意 ， 上 述 代码 在 对 字符 串 进 行 非 空 判断 的 时 候 使 用 了 
Textutils， isEmpty() 方 法 ， 这 是 一 个 非常 好 用 的 方法 ， 它 可 以 一 次 性 进 
行 两 种 空 值 的 判断 。 当 传 入 的 字符 串 等 于 nul11 或 者 等 于 空 字符 串 的 时 


全 这 个 方法 部 会 返回 true， 从 而 使 得 我 们 不 需要 先 单 独 判断 这 两 种 空 
值 再 使 用 逻辑 运算 符 连 接 起 来 了 。 


现在 重新 运行 一 下 程序 ， 刚 才 保存 的 Content 字 符 串 肯定 会 被 填充 到 











EditText 中 ， 然 后 编写 一 点 其 他 的 内 容 ， 比 如 在 EditText 中 输入 Hello， 
接着 按 下 Back 键 退出 程序 ， 再 重新 启动 程序 ， 这 时 刚才 输入 的 内 容 并 不 
会 丢失 ， 而 是 还 原 到 了 EditText 中 ， 如 图 6.6 所 示 。 








FilePersistenceTest 





Restoring succeeded 








图 6.6 成 功 还 原 保存 的 内 容 


这 样 我们 就 已 经 把 文件 存储 方面 的 知识 学 习 完了 ， 其 实 所 用 到 的 核心 技 
术 就 是 context 类 中 提供 的 openFileInput( ) 和 openFileoutput( ) 方 法 ， 
之 后 就 是 利用 Java 的 各 种 流 来 进行 读 写 操作 。 


不 过 正如 我 前 面 所 说 ， 文 件 存 储 的 方式 并 不 适合 用 于 保存 一 些 较 为 复杂 
的 文本 数据 ， 因 此 ， 下 面 我 们 就 来 学 习 一 下 Android 中 为 一 种 数据 持久 
化 的 方式 ， 它 比 文件 存储 更 加 简单 易 用 ， 而 且 可 以 很 方便 地 对 茶 一 指定 
的 数据 进行 读 写 操 作 。 








6.3 ”SharedPreferences 存 储 


不 同 于 文件 的 存储 方式 ，SharedPreferences 是 使 用 键 值 对 的 方式 来 存储 
数据 的 。 也 就 是 说 ， 当 保存 一 条 数据 的 时 候 ， 需 要 给 这 条 数据 提供 一 个 
对 应 的 键 ， 这 样 在 读 取 数据 的 时 候 束 可 以 通过 这 个 键 把 相应 的 值 取 出 
来 。 而 且 SharedPreferences 还 文 持 多 种 不 同 的 数据 类 型 存储 ， 如 果 存 储 
的 数据 类 型 是 整 型 ， 那 么 读 取 出 来 的 数据 也 是 整 型 的 ， 如 果 存 储 的 数据 
是 一 个 字符 串 ， 那 么 读 取 出 来 的 数据 仍然 是 字符 串 。 


这 样 你 应 该 就 能 明显 地 感觉 到 ， 使 用 SharedPreferences 来 进行 数据 持久 
化 要 比 使 用 文件 方便 很 多 ， 下 面 我 们 就 来 看 一 下 它 的 具体 用 法 吧 。 
6.3.1 将 数据 存储 到 SharedPreferences 中 


要 想 使 用 SharedPreferences 来 存储 数据 ， 首 先 需要 获取 
到 sharedpPreferences 对 象 。Android 中 主要 提供 了 3 种 方法 用 于 得 
到 sharedPreferences 对 象 。 








1. Context 类 中 的 getsharedPreferences() 方 法 


此 方法 接收 两 个 参数 ， 第 一 个 参数 用 于 指定 SharedPreferences 文 件 
的 名 称 ， 如 果 指 定 的 文件 不 存在 则 会 创建 一 个 ，SharedPreferences 
文件 都 是 存放 在 /data/data/<package name>/shared_prefs/ 目 录 下 的 。 
第 二 个 参数 用 于 指定 操作 模式 ， 目 前 只 有 MODE_PRIVATE 这 一 种 
模式 可 选 ， 它 是 默认 的 操作 模式 ， 和 直接 传 入 0 效果 是 相同 的 ， 表 
示 只 有 当前 的 应 用 程序 才 可 以 对 这 个 SharedPreferences 文 件 进行 读 
写 。 其 他 几 种 操作 模式 均 已 被 废弃 ，MODE_WORLD_READABLE 
和 MODE_WORLD_WRITEABLE 这 两 种 模式 是 在 Android ”4.2 版 本 
中 被 废弃 的 ，MODE _MULTI PROCESS 模 式 是 在 Android ”6.0 版 本 
中 被 废弃 的 。 


2. Activity 类 中 的 getPreferences() 方 法 





这 个 方法 和 Context 中 的 getsharedPreferences( ) 方 法 很 相似 ， 不 过 


它 只 接收 一 个 操作 模式 参数 ， 因 为 使 用 这 个 方法 时 会 自动 将 当前 活 
动 的 类 名 作为 SharedPreferences 的 文件 名 。 


3. PreferenceManager 类 中 的 getDefaultSharedPreferences() 方 法 


这 是 一 个 静态 方法 ， 它 接收 一 个 context 参 数 ， 并 自动 使 用 当前 应 
用 程序 的 包 名 作为 前 级 来 命名 SharedPreferences 文 件 。 得 到 了 
SharedPreferences 对 象 之 后 ， 就 可 以 开始 同 SharedPreferences 文 件 
中 存储 数据 了 ， 主 要 可 以 分 为 3 步 实现 。 


(1) 调用 sharedPreferences 对 象 的 edit() 方 法 来 获取 一 
个 sharedPreferences Editor 对 象 o 


(2) 问 SharedpPreferences.Editor 对 象 中 添加 数据 ， 比 如 添加 一 个 布 
尔 型 数据 就 使 用 putBoolean() 方 法 ， 添 加 一 个 字符 串 则 使 
用 putstring() 方 法 ， 以 此 类 推 。 


(3) 调用 apply() 方 法 将 添加 的 数据 提交 ， 从 而 完成 数据 存储 操作 。 


不 知 不 觉 中 己 经 将 理论 知识 介绍 得 挺 多 了 ， 那 我 们 就 赶快 通过 一 个 例子 
来 体验 一 下 SharedPreferences 存 储 的 用 法 吧 。 新 建 一 个 
SharedPreferencesTest 项 目 ， 然 后 修改 activity_main.xml 中 的 代码 ， 如 下 
所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:orientation="vertical" > 





<Button 
android:id="@+id/save_data" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Save data" 


</LinearLayout> 


这 里 我 们 不 做 任何 复杂 的 功能 ， 只 是 简单 地 放置 了 一 个 按钮 ， 用 于 将 一 
些 数据 存储 到 SharedPreferences 文 件 当中 。 然 后 修改 MainActivity 中 的 代 
人 码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 





@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity_main); 
Button SaveData = (Button) findViewById(R.id.save_data); 
saveData.setonClickListener(new View.OnClickListener() { 


@override 
public void onClick(View v) { 
SharedPreferences.Editor editor = getSharedPreferences("data" 
MODE_PRIVATE). edit( ); 
editor. putstring(" name", "Tom"); 
editor.putInt("age" 8); 
editor.putBoolean(" marriedn , false); 
editor.apply(); 


可 以 看 到 ， 这 里 首先 给 按钮 注册 了 一 个 反击 事件 ， 然 后 在 反击 事件 中 通 
过 getsharedPreferences() 方 法 指定 SharedPreferences 的 文件 名 为 data， 
并 得 到 了 sharedpPreferences.Editor 对 象 。 接 着 癌 这 个 对 象 中 添加 了 3 条 
最 后 调用 apply() 方 法 进行 提交 ， 从 而 完成 了 数据 存 
二 中 个 F 


很 简单 吧 ? 现在 就 可 以 运行 一 下 程序 了 ， 进 入 程序 的 主 界面 后 ， 点 击 一 
as data 按 钮 。 这 时 的 数据 应 该 已 经 保存 成 功 了 ， 不 过 为 了 证 实 一 
下 ， 我 们 还 是 要 借助 File Explorer 来 进行 查看 。 打 开 Android “Device 
Monitor， 并 点 击 File Explorer 标 签 页 ， 然 后 进入 
到 /data/data/com.example.sharedpreferencestest/shared_prefs/ 目 录 下 ， 可 以 
看 到 生成 了 一 个 data.xml 文 件 ， 如 图 6.7 所 示 。 


总 Threads 目 Heap 目 Allocation Tr... | 全 Network Stat... 志 , File Explorer 六 | 全 Emulator Co 口 System Infor..| 日 











险 自 | 一 |+ ” 

Name Size Date Time Permissions Info ~ 
BS com.example,filepersistencetest 2016-04-24 11:18 drwxr-x--x 
BE com.example.fragmentbestpractice 2016-04-10 08:50 drwxr-x--x 
BE com.example,fragmenttest 2016-04-09 15:20 drwxr-x--x 
区 com.example.listviewtest 2016-04-01 12:26 drwxr-x--x 
区 com.example.recyclerviewtest 2016-04-02 11:47 drwxr-x--x 
4 区 com.example.sharedpreferencestest 2016-04-30 11:30 drwxr-x--x 
GE cache 2016-04-30 11:29 drwxrwx--x 
GS code _cache 2016-04-30 11:29 drwxrwx--x 

GC flles 2016-04-30 11:29 drwx--…-- 3 

4 局 shared_prefs 2016-04-30 11:30 drwxrwx--x 有 
电 data.xml 186 2016-04-30 11:30 -rw-rw---- 
BS com.example.uibestpractice 2016-04-04 08:13 drwxr-x--x 
BG com.example.uicustomviews 2016-03-28 14:14 drwxr-x--x 
BB com.example.uilayouttest 2016-03-27 12:01 drwxr-x--x 
BB com.example,uisizetest 2016-04-04 05:12 drwxr-x--x 
BB com.google.android.apps.maps 2016-04-30 08:10 drwxr-x--x 


图 6.7 生成 的 data.xml 文 件 


接 下 来 ， 同 样 是 点 击 导 出 按钮 将 这 个 文件 导出 到 电脑 上 ， 并 用 记事 本 进 
行 查 看 ， 里 面 的 内 容 如 图 6.8 所 示 。 








文件 (日 ”编辑 (E) 格式 (O) ”查看 (V) ”帮助 (H) 





《9xml version= 1.0 encoding= utf-8 standalone= yes ?> 、 
<map> 

《string name= mame “2Tomkystring> 

<boolean name=" married” Value= ‘false” /> 

《int name="age” value= 28” /> 


</map> 





图 6.8 ”data.xml 文 件 中 的 内 容 


可 以 看 到 ， 我 们 刚刚 在 按钮 的 点 击 事 件 中 添加 的 所 有 数据 都 已 经 成 功 保 
ee ， 并 且 SharedPreferences 文 件 是 使 用 XML 格式 来 对 数据 进行 管 
理 的 。 


那么 接 下 来 我 们 自然 要 看 一 看 ， 如 何 从 SharedPreferences 文 件 中 去 读 取 
这 些 数据 了 。 


6.3.2” 从 SharedPreferences 中 读 取 数据 


你 应 该 已 经 感觉 到 了 ， 使 用 SharedPreferences 来 存储 数据 是 非常 简单 
的 ， 不 过 下 面 还 有 更 好 的 消息 ， 其 实 从 SharedPreferences 文 件 中 读 取 数 
据 会 更 加 地 简单 。sharedPreferences 对 象 中 提供 了 一 系列 的 get 方 法 ， 
用 于 对 存储 的 数据 进行 读 取 ， 每 种 get 方 法 都 对 应 了 
SharedPreferences .Editor 中 的 一 种 put 方 法 ， a 
就 使 用 getBoolean() 方 法 ， 读 取 一 个 字符 串 就 使 用 getstring() 方 法 。 

些 get 方 法 都 接收 两 个 参数 ， 第 一 个 参数 是 键 ， 传 忠 在 信 数 昧 时 使 用 的 





键 束 可 以 得 到 相应 的 值 了 ; 第 二 个 参数 是 默认 值 ， 即 表示 当 传 入 的 键 找 
不 到 对 应 的 值 时 会 以 什么 样 的 默认 值 进行 返回 。 


我 们 还 是 通过 例子 来 实际 体验 一 下 吧 ， 仍 然 是 在 SharedPreferencesTest 项 
目的 基础 上 继续 开发 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:1layout_ height=" ‘match_parent" 
android:orientation="vertical" 


<Button 
android:id="@+id/save_data" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Save data" 
/> 


<Button 
android:id="@+id/restore_data" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Restore data" 
/> 





</LinearLayout> 








这 里 增加 了 一 个 还 原 数据 的 按钮 ， 我 们 希望 通过 点 击 这 个 按钮 来 从 


SharedPreferences 文 件 中 读 取 数据 。 修 改 MainActivity 中 的 代码 ， 如 下 所 
小 : 


public class MainActivity extends AppCompatActivity { 


@Ooverride 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity main); 


Button restoreData = (Button) findViewById(R.id.restore_data); 
restoreData.setOonClickListener(new View.OnClickListener() { 
@override 
public void onClick(View v) { 
Sharedpreferences pref = getSharedpreferences(" ‘data", MODE_PRIVATE); 
String name = pref. getString(” name", ""); 
int age = pref. getInt(" age" 
boolean married = pref .getBoolean( ‘married", false); 
Log.d("MainActivity", "name is " + name); 
Log.d("MainActivity", "age is " + age); 
Log.d("MainActivity", "married is " + married); 





可 以 看 到 ， 我 们 在 还 原 数据 按钮 的 点 击 事件 中 首先 通过 
getSharedPreferences() 方 法 得 到 了 SharedPreferences 对 象 ， 然后 分 别 
调用 它 的 getstring()、getInt() 和 getBoolean() 方 法 ， 去 获取 前 面 所 存 
储 的 姓名 、 年 龄 和 是 否 已 婚 ， 如 有 果 没 有 找到 相应 的 值 ， 就 会 使 用 方法 中 
传 入 的 默认 值 来 代 蔡 ， 最 后 通过 Log 将 这 些 值 打印 出 来 。 


现在 重新 运行 一 下 程序 ， 并 点 击 界面 上 的 Restore data 按钮 ， 然 后 查看 











logcat 中 的 打印 信息 ， 如 图 6.9 所 示 。 





Verbose 加 IQr 


com. example. sharedpreferencestest D/MainActivity: name is Tom 





com. example. sharedpreferencestest D/MainActivity: age is 28 


com. example. sharedpreferencestest D/MainActivity: married is false 


图 6.9 打印 data.xml 中 存储 的 内 容 


所 有 之 前 存储 的 数据 都 成 功 读 取 出 来 了 ! 通过 这 个 例子 ， 我 们 惑 把 
SharedPreferences 存 储 的 知识 也 学 习 完 了 。 相 比 之 下 ，SharedPreferences 
存储 确实 要 比 文本 存储 简单 方便 了 许多 ， 应 用 场景 也 多 了 不 少 ， 比 如 很 
多 应 用 程序 中 的 偏好 设置 功能 其 实 都 使 用 到 了 0 
那么 下 面 我 们 就 来 编写 一 个 记 住 密码 的 功能 ， 相 信 通 过 这 个 例子 能 够 加 
深 你 对 SharedPreferences 的 理解 。 


6.3.3 ”实现 记 住 密码 功能 


既然 是 实现 记 住 密码 的 功能 ， 那 么 我 们 束 不 需要 从 头 去 写 了 ， 因 为 在 上 

一 草 中 的 最 佳 实践 部 分 已 经 编写 过 一 个 登录 界面 了 ， 有 可 以 重用 的 代码 
为 什么 不 用 呢 ? 那 就 首先 打开 BroadcastBestPractice 项 目 ， 来 编辑 一 下 登 
录 界 面 的 布局 。 修 改 activity_login.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 





<LinearLayout 
android:orientation="horizontal" 
android:layout_width="match_parent" 
android:layout_height="wrap_content"> 
<CheckBox 
android:id="@+id/remember_pass" 
android:layout_ width="wrap_content" 
android:layout_height="wrap_content" /> 


<TextView 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:textSize="18sp" 
android:text="Remember password" /> 
</LinearLayout> 


<Button 
android:id="@+id/1login" 
android:layout_width="match_parent" 
android: Layout- height="60dp" 
android:text="Login" /> 
</LinearLayout> 


这 里 使 用 到 了 一 个 新 控件 CheckBox。 这 是 一 个 复 选 框 控件 ， 用 户 可 以 
通过 点 击 的 方式 来 进行 选中 和 取消 ， 我 们 就 使 用 这 个 控件 来 表示 用 户 是 











否 需 要 记 住 密码 。 


然后 修改 LoginActivity 中 的 代码 ， 如 下 所 示 : 


public class LoginActivity extends BaseActivity { 
private SharedPreferences pref; 
private SharedPreferences.Editor editor; 
private EditText accountEdit; 
private EditText passwordEdit 
private Button login; 
private CheckBox rememberPass 


@override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceSstate); 
setContentView(R.1layout.activity_ login); 
pref = PreferenceManager .getDefaultSharedPreferences(this); 
accountEdit = (EditText) findViewById(R.id.account); 
passwordEdit = (EditText) findViewById(R.id.password); 
rememberPass = (CheckBox) findViewById(R.id.remember_pass); 
login = (Button) findViewById(R.id.1o0ogin); 
boolean isRemember = pref.getBoolean("remember_password", false); 
if (isRemember) { 





// 将 账号 和 密码 都 设置 到 文本 框 中 
String account = pref.getstring("account", ""); 
String password = pref.getstring("password", ""); 


accountEdit.setText(account); 
passwordEdit.setText(password); 
rememberPass.setChecked(true); 





login.setOonClickListener(new View.OnClickListener() { 


@override 
public void onClick(View v) { 
String account = accountEdit.getText().toSstring(); 


String password = passwordEdit.getText().tostring(); 
// 如 果 账 号 是 admin 且 密码 是 123456， 就 认为 登录 成 功 
if (account .equals("admin") && password.equals("123456" ) ) { 
editor = pref.edit(); 
if (rememberPass.isChecked()) { // 检查 复 选 框 是 否 被 选中 
editor.putBoolean("remember_password", true); 
editor.putstring("account", account); 
editor.putstring("password", password); 
} else { 
editor.clear(); 








} 

editor.apply(); 

Intent intent = new Intent(LoginActivity.this, MainActivity. 
class): 

startActivity(intent); 

finish(); 

} else { 

Toast .makeText (LoginActivity.this, "account or password is 
invalid", 
Toast .LENGTH _SHORT) . show( ); 


}); 





可 以 看 到 ， 这 里 首先 在 oncreate() 方 法 中 获取 到 了 sharedPreferences 对 
象 ， 然 后 调用 它 的 getBoolean() 方 法 去 获取 remember_password 这 个 键 对 
应 的 值 。 一 开始 当然 不 存在 对 应 的 值 了 ， 所 以 会 使 用 默认 值 false， 这 
样 就 什么 都 不 会 发 生 。 接 着 在 登录 成 功 之 后 ， 会 调用 CheckBox 的 
isCchecked() 方 法 来 检查 复 选 框 是 否 被 选中 ， 如 果 被 选中 了 ， 则 表示 用 








户 想 要 记 住 密码 ， 这 时 将 remember_password 设 置 为 true， 然 后 把 
account 和 password 对 应 的 值 都 存 入 到 SharedPreferences 文 件 当中 并 提 
交 。 如 果 没 有 被 选中 ， 就 简单 地 调用 一 下 clear() 方 法 ， 将 
SharedPreferences 文 件 中 的 数据 全 部 清除 挥 。 


当 用 户 选中 了 记 住 密码 复 选 框 ， 并 成 功 登 录 一 次 之 

后 ， remember_password 键 对 应 的 值 就 是 true 了 ， 这 个 时 候 如 果 再 重新 启 
动 登录 界面 ， 就 会 从 SharedPreferences 文 件 中 将 保存 的 账号 和 密码 都 读 
取出 来 ， 并 填充 到 文本 输入 框 中 ， 然 后 把 记 住 密码 复 选 框 选中 ， 这 样 就 
完成 记 住 密码 的 功能 


现在 重新 运行 一 下 程序 ， 可 以 看 到 界面 上 多 出 了 一 个 记 住 密码 复 选 框 ， 
如 图 6.10 所 示 。 
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BroadcastBestPractice 




















图 6.10 ”和 带 记 住 密 码 复 选 框 的 登录 界面 





然后 账号 输入 admin， 密 码 输入 123456， 并 选中 记 住 密码 复 选 框 ， 点 击 
登录 ， 束 会 跳 转 到 MainActivity。 接 着 在 MainActivity 中 发 出 一 条 强制 下 
线 广播 ， 会 让 程序 重新 加 到 登录 界面 ， 此 时 你 会 有 发现 ， 账 号 密码 都 已 经 
自动 填充 到 界面 上 了 ， 如 图 6.11 所 示 。 





BroadcastBestPractice 


Account: admin 





Remember password 








图 6.11 实现 记 住 账号 密码 功能 


这 样 我 们 就 使 用 SharedPreferences 技 术 将 记 住 密码 功能 成 功 实 现 了 ， 你 
是 不 是 对 SharedPreferences 理 解 得 更 加 深刻 了 呢 ? 


不 过 需要 注意 ， 这 里 实现 的 记 住 密码 功能 仍然 只 是 个 简单 的 示例 ， 并 不 
能 在 实际 的 项 目 中 直接 使 用 。 因 为 将 密码 以 明文 的 形式 存储 在 
SharedPreferences 文 件 中 是 非常 不 安全 的 ， 很 容易 束 会 补 别 人 资 取 ， 
此 在 正式 的 项 目 里 还 需要 结合 一 定 的 加 密 算法 来 对 密码 进行 保护 才 行 。 











好 了 ， 关 于 SharedPreferences 的 内 容 就 讲 到 这 里 ， 接 下 来 我 们 要 学 习 一 
下 本 章 的 重头 戏 一 -Android 中 的 数据 库 技 术 。 





6.4 SQLite 数 据 库存 储 


在 刚 开 始 接触 Android 的 时 候 ， 我 甚至 都 不 敢 相 信 ，Android 系 统 竟然 是 
内 置 了 数据 库 的 ! 好 吧 ， 是 我 太 孤 陋 寡 闻 了 。SQLite 是 一 款 轻 量 级 的 关 
系 型 数据 库 ， 它 的 运算 速度 非常 快 ， 占 用 资源 很 少 ， 通 常 只 需要 几 百 
KB 的 内 存 就 足够 了 ， 因 而 特别 适合 在 移动 设备 上 使 用 。SQLite 不 仅 支 
持 标 准 的 SQL 语法 ， 还 遵循 了 数据 库 的 ACID 事务 ， 所 以 只 要 你 以 前 使 
用 过 其 他 的 关系 型 数据 库 ， 就 可 以 很 快 地 上 手 SQLite。 而 SQLite 又 比 一 
般 的 数据 库 要 简单 得 多 ， 它 甚至 不 用 设置 用 户 名 和 密码 就 可 以 使 用 。 
Android 正 是 把 这 个 功能 极为 强大 的 数据 库 风 入 到 了 系统 当中 ， 使 得 本 
地 持久 化 的 功能 有 了 一 次 质 的 飞跃 。 


前 面 我 们 所 学 的 文件 存储 和 SharedPreferences 存 储 毕竟 只 适用 于 保存 一 
些 简 单 的 数据 和 键 值 对 ， 当 需要 存储 大 量 复杂 的 关系 型 数据 的 时 候 ， 你 
就 会 发 现 以 上 两 种 存储 方式 很 难 应 付 得 了 。 比 如 我 们 手机 的 短信 程序 中 
可 能 会 有 很 多 个 会 话 ， 每 个 会 话 中 又 包含 了 很 多 条 信息 内 容 ， 并 且 大 部 
分 会 话 还 可 能 各 上 自 对 应 了 电话 短 中 的 某 个 联系 人 。 很 难 想象 如 何 用 文件 
或 者 SharedPreferences 来 存储 这 些 数 据 量 大 、 结 构 性 复杂 的 数据 吧 ? 但 
是 使 用 数据 库 就 可 以 做 得 到 。 那 么 我 们 就 赶快 来 看 一 看 ，Android 中 的 
SQLite 数 据 库 到 底 是 如 何 使 用 的 。 


6.4.1 创建 数据 库 


Android 为 了 让 我 们 能 够 更 加 方便 地 管理 数据 库 ， 专 门 提供 了 一 个 
SQLiteOpenHelper 帮 助 类 ， 借 助 这 个 类 就 可 以 非常 简单 地 对 数据 库 进行 
创建 和 升级 。 既 然 有 好 东西 可 以 直接 使 用 ， 那 我 们 自然 要 尝试 一 下 了 ， 
下 面 我 就 对 SQLiteOpenHelper 的 基本 用 法 进行 介绍 。 


自 先 你 要 知道 SQLiteOpenHelper 是 一 个 抽象 类 ， 这 童 味 着 如 果 我 们 想 要 
使 用 它 的 话 ， 就 需要 创建 一 个 自己 的 帮助 类 去 继承 它 。 
SQLiteOpenHelper 中 有 两 个 抽象 方法 ， 分 别 是 oncreate( ) 和 
onUpgrade()， 我 们 必须 在 自己 的 帮助 类 里 面 重 写 这 两 个 方法 ， 然 后 分 
别 在 这 两 个 方法 中 去 实现 创建 、 升 级 数据 库 的 逻辑 。 


SQLiteOpenHelper 中 还 有 两 个 非常 重要 的 实例 方 



































法 : getReadableDatabase( ) getwritableDatabase( ) 。 这 两 个 方法 都 可 
以 创建 或 打开 一 个 现 有 的 数据 库 ( 如 果 数 据 库 已 存在 则 直接 打开 ， 否 则 
创建 一 个 新 的 数据 库 ) ， 并 返回 一 个 可 对 数据 库 进行 读 写 操作 的 对 象 。 
不 同 的 是 ， 当 数据 库 不 可 写 入 的 时 候 〈 如 磁盘 空间 已 
满 ) ，getReadableDatabase() 方 法 返回 的 对 象 将 以 只 读 的 方式 去 打开 数 
据 库 ， 而 getwritableDatabase() 方 法 则 将 出 现 异 常 。 


SQLiteOpenHelper 中 有 两 个 构造 方法 可 供 重 写 ， 一 般 使 用 参数 少 一 点 的 
那个 构造 方法 即 可 。 这 个 构造 方法 中 接收 4 个 参数 ， 第 一 个 参数 是 
Context， 这 个 没什么 好 说 的 ， 必 须要 有 它 才 能 对 数据 库 进 行 操作 。 第 二 
个 参数 是 数据 库 名 ， 创 建 数据 库 时 使 用 的 就 是 这 里 指定 的 名 称 。 第 三 个 
参数 允许 我 们 在 查询 数据 的 时 候 返 回 一 个 自 定 义 的 Cursor， 一 般 都 是 传 
入 null1。 第 四 个 参数 表示 当前 数据 库 的 版 本 写 ， 可 用 于 对 数据 库 进 行 升 
级 操作 。 构 建 出 SQLiteOpenHelper 的 实例 之 后 ， 再 调用 它 的 
getReadableDatabase( ) 或 getwritableDatabase( ) 方 法 就 能 够 创建 数据 库 
了 ， 数 据 库 文件 会 存放 在 /data/data/<package name>/databases/ 目 录 下 。 
此 时 ， 重 写 的 oncreate() 方 法 也 会 得 到 执行 ， 所 以 通常 会 在 这 里 去 处 理 
一 些 创建 表 的 逻辑 。 


接 下 来 还 是 让 我 们 通过 例子 的 方式 来 更 加 直观 地 体会 SQLiteOpenHelper 
的 用 法 吧 ， 首 先 新 建 一 个 DatabaseTest 项 目 。 


这 里 我 们 希望 创建 一 个 名 为 BookStore.db 的 数据 库 ， 然 后 在 这 个 数据 库 
中 新 建 一 张 Book 表 ， 表 中 有 id (主键 )、 作 者 、 价 格 、 页 数 和 书 名 等 
列 。 创 建 数据 库 表 当然 还 是 需要 用 建 表 语 句 的 ， 这 里 也 是 要 考验 一 下 你 
的 SQL 基 本 功 了 ，Book 表 的 建 表 语 句 如 下 所 示 : 




















只 要 你 对 SQL 方面 的 知识 稍微 有 一 些 了 解 ， 上 面 的 建 表 语句 对 你 来 说 应 
该 都 不 难 吧 。SQLite 不 像 其 他 的 数据 库 拥有 众多 繁杂 的 数据 类 型 ， 它 的 
数据 类 型 很 简单 ，integer 表 示 整 型 ，real 表 示 浮 点 型 ，text 表 示 文 本 类 
型 ，plob 表 示 二 进 制 类 型 。 男 外 ， 上 述 建 表 语句 中 我 们 还 使 用 了 
primary key 将 id 列 设 为 主键 ， 并 用 autoincrement 关 键 字 表示 id 列 是 自 
增长 的 。 





然后 需要 在 代码 中 去 执行 这 条 SQL 语句 ， 才 能 完成 创建 表 的 操作 。 新 建 
MyDatabaseHelper 类 继承 自 SQLiteOpenHelper， 代 人 码 如 下 所 示 : 


public class MyDatabaseHelper extends SQLiteOpenHelper { 


public static final String CREATE BOOK = "create table Book (" 
"id integer primary key autoincrement, " 

"author text, " 

"price real, " 

"pages integer, " 

"name text)"; 


+ 二 二 十 十 


private Context mContext; 


public MyDatabaseHelper(Context context, String name, 
SQLiteDatabase.CursorFactory factory, int version) { 
super(context, name, factory, version); 
mContext = context; 


} 


@override 
public void onCreate(SQLiteDatabase db) { 

db .execSQL (CREATE_ BOOK); 

Toast.makeText(mContext, "Create succeeded", Toast.LENGTH_SHORT).show(); 
} 


@override 
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 


} 





可 以 看 到 ， 我 们 把 建 表 语句 定义 成 了 一 个 字符 串 常量 ， 然 后 

在 oncreate() 方 法 中 叉 调 用 了 SQLiteDatabase 的 execsQL() 方 法 去 执行 这 
条 建 表 语 句 ， 并 弹出 一 个 Toast 提 示 创 建成 功 ， 这 样 就 可 以 保证 在 数据 
库 创 建 完成 的 同时 还 能 成 功 创建 Book 表 。 


现在 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
> 





<Button 
android:id="@+id/create_database" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Create database" 
了 > 


</LinearLayout> 





布局 文件 很 简单 ， 束 是 加 入 了 一 个 按钮 ， 用 于 创建 数据 库 。 节 后 修改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
private MyDatabaseHelper dbHelper; 


@override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedIinstanceState); 
setContentView(R.1layout.activity main); 
dbHelper = new MyDatabaseHelper(this, "BookStore.db", null, 1); 
Button createDatabase = (Button) findViewById(R.id.create database); 
createDatabase.setonClickListener(new View.OnClickListener() { 


Q@override 
public void onClick(View v) { 
dbHelper .getwrita ple Database( ); 


这 里 我 们 在 oncreate( ) 方 法 中 构建 了 一 个 MyDatabaseHelper 对 象 ， 并 且 
通过 构造 函数 的 参数 将 数据 库 名 指定 为 BookStore.db， 版 本 号 指定 为 1， 
然后 在 Create database 按 钮 的 点 击 事件 里 调用 了 getwritableDatabase() 
方法 。 这 样 当 第 一 次 点 击 Create ”database 按 钮 和 时， 就 会 检测 到 当前 程序 
中 并 没有 BookStore.db 这 个 数据 库 ， 于 是 会 创建 该 数据 库 并 调用 
MyDatabaseHelper 中 的 oncreate() 方 法 ， 这 样 Book 表 也 就 得 到 了 创建 ， 
然后 会 弹出 一 个 Toast 提 示 创 建成 功 。 再 次 点 击 Create database 按 钮 时 ， 
会 发 现 此 时 已 经 存在 BookStore.db 数 据 库 了 ， 因 此 不 会 再 创建 一 次 。 


现在 就 可 以 运行 一 下 代码 了 ， 在 程序 主 界面 点 击 Create “database 按钮 ， 
结果 如 图 6.12 所 示 。 














DatabaseTest 


CREATE DATABASE 












图 6.12 ”创建 数据 库 成 功 


此 时 BookStore.db 数 据 库 和 Book 表 应 该 都 已 经 创建 成 功 了 ， 因 为 当 你 再 
次 点 击 Create database 按 钮 时 ， 不 会 再 有 Toast 弹 出 。 可 是 又 回 到 了 之 前 
的 那个 老 问 题 ， 怎 样 才能 证 实 它 们 的 确 创建 成 功 了 ? 如 果 还 是 使 用 File 
Explorer， 那 么 最 多 你 只 能 看 到 databases 目 录 下 出 现 了 一 个 BookStore.db 
文件 ，Book 表 是 无 法 通过 File Explorer 看 到 的 。 因 此 这 次 我 们 准备 换 一 
种 查看 方式 ， 使 用 adb shell 来 对 数据 库 和 表 的 创建 情况 进行 检查 。 


adb 是 Android SDK 中 目 币 的 一 个 调试 工具 ， 使 用 这 个 工具 可 以 直接 对 连 
接 在 电脑 上 的 手机 或 模拟 器 进行 调试 操作 。 它 存放 在 sdk 的 platform-tools 
目录 下 ， 如 果 想 要 在 命令 行 中 使 用 这 个 工具 ， 就 需要 先 把 它 的 路 径 配 置 
到 环境 变量 里 。 


如 果 你 使 用 的 是 Windows 系 统 ， 可 以 右 击 计算 机 -~ 属性 ~ 高 级 系统 设置 











~ 环境 变量 ， 然 后 在 系统 变量 里 找到 Path 并 点 击 编辑 ， 将 platform-tools 
目录 配置 进去 ， 如 图 6.13 所 示 。 





编辑 系统 变量 








变量 名 略 ) : Fath 


变量 值 0 : ta\Local\Android\sdk\platform-tools 


确定 取消 

















系统 变量 GS) 


变星 值 

Os Windows_HT 

Fath C:\Windows\system32:C: Windows;... 
FATHEXT COM BRE DAE CM YD. VE 
PRnPRSSDR AR 点 由 TIR 际 区 


新 建 册 ). .| | 编辑 CI)... 用 除 (L) 


EE 
































图 6.13 Windows 下 配置 环境 变量 


如 果 你 使 用 的 是 Linux 或 Mac 系 统 ， 可 以 在 home 路 径 下 编辑 .bash_ 文 件 ， 
将 platform-tools 目 录 配 置 进去 即 可 ， 如 图 6.14 所 示 。 


Terminal 


/android-sdk-linux/platform-tools 





图 6.14 Linux 或 Mac 下 配置 环境 变量 


配置 好 了 环境 变量 之 后 ， 就 可 以 使 用 adb 工 具 了 。 打 开 命 令 行 界 面 ， 输 
入 adb shell， 就 会 进入 到 设备 的 控制 台 ， 如 图 6.15 所 示 。 





耳 Te T 
CN\Windows\system32\cmd.exe - adb shell ,| 


Microsoft Windows [人 本 6.1.?681 ] a 
[= 





CNMsersNIonuy>adhb shell 


间 





图 6.15 进入 设备 的 控制 台 


其 中 ，# 符 号 是 超级 管理 员 的 意思 ， 也 就 是 说 现在 你 可 以 访问 模拟 器 中 
的 一 切 数据 。 如 果 你 的 命令 行 上 显示 的 是 $ 符 号 ， 那 么 就 表示 你 现在 是 
普 裔 管理 员 ， 需 输入 su 命令 切换 成 超级 管理 员 ， 才 能 执行 下 面 的 操作 。 











接 下 来 使 用 cd 命令 进入 到 /data/data/com.example.databasetest/databases/ 日 
录 下 ， 并 使 用 1s 命 令 查 看 到 该 目录 里 的 文件 ， 如 图 6.16 所 示 。 





| 一 
芭 CNVWindows\system32\cmd,.exe - adb shell 





CNMsersNIonuy>adhb shell 
划 cd data/data/com.example.databasetest/databases/ 
cd /data/data/com.example.databasetest/databases/ 


BookStore .db 


BookStore .db—journal 
站 





图 6.16 查看 数据 库 文件 


这 个 目录 下 出 现 了 两 个 数据 库 文件 ， 一 个 正 是 我 们 创建 的 
BookStore.db， 而 男 一 个 BookStore.db-journal 则 是 为 了 让 数据 库 能 够 支 
持 事 务 而 产生 的 临时 日 志文 件 ， 通 常情 况 下 这 个 文件 的 大 小 都 是 0 字 
I 








接 下 来 我 们 就 要 借助 sqlite 命 令 来 打开 数据 库 了 ， 只 需要 键入 sqlite3， 
后 面 加 上 数据 库 名 即 可 ， 如 图 6.17 所 示 。 








le 
町 CNVWindows\system32\Vcmd.exe - adb shell 






# sqlite3 BookStore .dh 

sqlite3 BookStore .db 

SQLite version 3.7.4 

Enter ".help for instructions 

Enter SQL statements terminated with a "ss" 


sqlite> 








图 6.17 打开 BookStore.db 数 据 库 

这 时 就 已 经 打开 了 BookStore.db 数 据 库 ， 现 在 就 可 以 对 这 个 数据 库 中 的 
表 进行 管理 了 。 首 先 来 看 一 下 目前 数据 库 中 有 哪些 表 ， 刍 入 .table 命 
令 ， 如 图 6.18 所 示 。 








Pas 一 
es C\Windows\system32\cmd.exe - adb shell 


android_metadata 





图 6.18 ”查看 表 

可 以 看 到 ， 此 时 数据 库 中 有 两 张 表 ，android_metadata 表 是 每 个 数据 库 
中 都 会 自动 生成 的 ， 不 用 管 它 ， 而 另外 一 张 Book 表 就 是 我 们 在 
MyDatabaseHelper 中 创建 的 了 。 这 里 还 可 以 通过 .schema 命 令 来 查看 它们 
的 建 表 语句 ， 如 图 6.19 所 示 。 








CREATE TABLE Book Cid integer primary key autoincrement, author text, price Feal 


» pages integer,. name text>; 
CREATE TABLE android_metadata locale TEXT»; 
sqlite> 








图 6.19 ”查看 建 表 语句 


由 此 证 明 ，BookStore.db 数 据 库 和 Book 表 确实 已 经 创建 成 功 了 。 之 后 键 
入 .exit 或 .quit 命 令 可 以 退出 数据 库 的 编辑 ， 再 键入 exit 命 令 束 可 以 退 
出 设备 控制 台 了 。 


6.4.2 升级 数据 库 


如 果 你 足够 细心 ， 一 定 会 发 现 MyDatabaseHelper 中 还 有 一 个 空 方法 呢 ! 
没 错 ，onUpgrade( ) 方 法 是 用 于 对 数据 库 进行 升级 的 ， re 
的 管理 工作 当中 起 着 非常 重要 的 作用 ， 可 和 干 万 不 能 忽视 它 哆 。 


目前 DatabaseTest 项 目 中 己 经 有 一 张 Book 表 用 于 存放 书 的 各 种 详细 数 
据 ， 如 果 我 们 想 再 添加 一 张 Category 表 用 于 记录 图 书 的 分 类 ， 该 怎么 做 
呢 ? 


比如 Category 表 中 有 id 主 键 〉、 分 类 名 和 分 类 代码 这 几 个 列 ， 那 么 
表 语 句 就 可 以 写成 : 


create table Category ( 
id integer primary key autoincrement, 
category_name text, 
category_code integer) 








接 下 来 我 们 将 这 这 条 建 表 语句 添加 到 MyDatabaseHelper 中 ， 人 代码 如 下 所 
小 : 


public class MyDatabaseHelper extends SQLiteOpenHelper { 


public static final String CREATE BOOK = "create table Book (" 
+ "id integer primary key autoincrement, 
+ “author text; " 
+ "price real, " 
+ ,pages integer, 
+ "name text)"; 


public static final String CREATE_CATEGORY = "Create table Category (" 
+ "id integer primary key autoincrement, 


+ "category_name text, " 
+ "category_code integer)"; 


private Context mContext; 


public MyDatabaseHelper(Context context, String name, 
SQLiteDatabase.CursorFactory factory, int version) { 
super(context, name, factory, version); 
mContext = context; 


} 


@override 
public void onCreate(SQLiteDatabase db) { 
db .execSQL(CREATE_BOOK) ; 
db .execSQL(CREATE_CATEGORY ) ; 
Toast .makeText(mContext， "Create Succeeded"，Toast .LENGTH_SHORT) .show() ， 


@override 
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 








看 上 去 好 像 都 挺 对 的 吧 ? 现在 我 们 重新 运行 一 下 程序 ， 并 点 击 Create 
database 按 钮 ， 喷 ? 竟然 没有 弹出 创建 成 功 的 提示 。 当 然 ， 你 也 可 以 通 
过 adb 工 具 到 数据 库 中 再 去 检查 一 下 ， 这 样 你 会 更 加 地 确认 Category 表 没 
有 创建 成 功 ! 


其 实 没 有 创建 成 功 的 原因 不 难 思 考 ， 因 为 此 时 BookStore.db 数 据 库 已 经 
存在 了 ， 之 后 不 管 我 们 怎样 点 击 Create database 按 钮 ，MyDatabaseHelper 
| ) 方 法 都 不 会 再 次 执行 ， 因 此 新 添加 的 表 也 就 无 法 得 到 创 
建 :x 


解决 这 个 问题 的 办 法 也 相当 简单 ， 只 需要 驳 将 程序 番 载 掉 ， 然 后 重新 运 
行 ， 这 时 BookStore.db 数 据 库 已 经 不 存在 了 ， 如 果 再 点 击 Create database 
按钮 ，MyDatabaseHelper 中 的 oncreate() 方 法 就 会 执行 ， 这 时 Category 
表 束 可 以 创建 成 功 了 。 


不 过 ， 通 过 凶 载 程序 的 方式 来 新 增 一 张 表 竖 无 疑问 是 很 极端 的 做 法 ， 其 


实 我 们 只 需要 巧妙 地 运用 SQLiteOpenHelper 的 升级 功能 就 可 以 很 轻松 地 
解决 这 个 问题 。 修 改 MyDatabaseHelper 中 的 代码 ， 如 下 所 示 : 


public class MyDatabaseHelper extends SQLiteOpenHelper { 











@Override 

public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 
db .execSQL("drop table if exists Book"); 
db .execSQL("drop table if exists Category"); 
onCreate(db); 


可 以 看 到 ， 我 们 在 onupgrade() 方 法 中 执行 了 两 条 DRoP 语 句 ， 如 果 发 现 数 








据 库 中 已 经 存在 Book 表 或 Category 表 了 ， 束 将 这 两 张 表 删 除 掉 ， 然 后 再 
调用 oncreate() 方 法 重新 创建 。 这 里 先 将 已 经 存在 的 表 删 除 掉 ， 因 为 如 
果 在 创建 表 时 发 现 这 张 表 已 经 存在 了 ， 束 会 直接 报错 。 


接 下 来 的 问题 就 是 如 何 让 onupgrade( ) 方 法 能 够 执行 了 ， 还 记得 
SQLiteOpenHelper 的 构造 方法 里 接收 的 第 四 个 参数 吗 ? 它 表 示 当 前 数据 
库 的 版 本 号 ， 之 前 我 们 传 入 的 是 1， 现 在 只 要 传 入 一 个 比 1 大 的 数 ， 就 可 
以 让 onupgrade() 方 法 得 到 执行 了 。 人 和 修改 MainActivity 中 的 代码 ， 如 下 所 
NN": 














public class MainActivity extends AppCompatActivity { 
private MyDatabaseHelper dbHelper; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity_i main); 
dbHelper = new MyDatabaseHelper(this, "BookStore.db", null, 2); 


Button createDatabase = (Button) findViewById(R.id. create _database ) 
createDatabase.Sset0nClickListener(new View.OnClickListener() { 
@Override 


public void onClick(View v) 
dbHelper .getwritableDatabase( ); 


这 里 将 数据 库 版 本 号 指定 为 2， 表 示 我 们 对 数据 库 进 行 升级 了 。 现 在 重 
新 运行 程序 ， 并 点 击 Create ”database 按 钮 ， 这 时 就 会 再 次 弹出 创建 成 功 
的 提示 。 为 了 验证 一 下 Category 表 是 不 是 已 经 创建 成 功 了 ， 我 们 在 adb 

shel1 中 打开 BookStore.db 数 据 库 ， 然 后 键入 .table 人 命令， 结果 如 图 6.20 
所 示 。 








CGCategory andkoid_metadata 








图 6.20 ”查看 新 增 表 
接着 键入 .schema 命令 查看 一 下 建 表 语句 ， 结 果 如 图 6.21 所 示 。 








sqlite> -Schema 


.SChema 
CREATE TABLE Book id integer primary key autoincrement, author text, price real 


» pages integer,. name text»; 

CREATE TABLE Category 《id integer primary key autoincrement, category_name text. 
category_code integer?; 

GCREATE TABLE android_metadata locale TEXT7>3; 

sqlite> 








图 6.21 查看 新 增 建 表 语 人 句 


由 此 可 以 看 出 ，Category 表 已 经 创建 成 功 了 ， 同 时 也 说 明 我 们 的 升级 功 
能 的 确 起 到 了 作用 。 


6.4.3 ”添加 数据 


现在 你 已 经 掌握 了 创建 和 升级 数据 库 的 方法 ， 接 下 来 就 该 学 习 一 下 如 何 
对 表 中 的 数据 进行 操作 了 。 其 实 我 们 可 以 对 数据 进行 的 操作 无 非 有 4 
种 ， 即 CRUD 。 其 中 C 代 表 添 加 〈Create) ，R 代 表 查 询 (Retrieve) ，U 
代表 更 新 〈Update) ，D 代 表 删 除 (Delete) 。 每 一 种 操作 又 各 自 对 应 
了 一 种 SQL 命令 ， 如 果 你 比较 熟悉 SQL 语言 的 话 ， 一 定 会 知道 添加 数据 
时 使 用 insert， 查 询 数 据 时 使 用 select， 更 新 数据 时 使 用 update， 删 除 
数据 时 使 用 delete。 但 是 开发 者 的 水 平 总 会 是 参 堪 不 齐 的 ， 未 必 每 一 个 
人 都 能 非常 熟悉 地 使 用 SQL 语 言 ， 因 此 Android 也 提供 了 一 系列 的 辅助 
性 方法 ， 使 得 在 Android 中 即使 不 去 编写 SQL 语句 ， 也 能 轻松 完成 所 有 
的 CRUD 操 作 。 








前 面 我 们 已 经 知道 ， 调 用 SQLiteOpenHelper 的 getReadableDatabase() 
或 getwritableDatabase() 方 法 是 可 以 用 于 创建 和 升级 数据 库 的 ， 不 仅 如 
此 ， 这 两 个 方法 还 都 会 返回 一 个 SQLiteDatabase 对 象 ， 借 助 这 个 对 象 就 
可 以 对 数据 进行 CRUD 操 作 了 。 


那么 下 面 我 们 首先 学 习 一 下 如 何 问 数据 库 的 表 中 添加 数据 

吧 。seQLiteDatabase 中 提供 了 一 个 insert() 方 法 ， 这 个 方法 就 是 专门 用 
于 添加 数据 的 。 它 接收 3 个 参数 ， 第 一 个 参数 是 表 名 ， 我 们 希望 回 哪 张 
表 里 添 加 数据 ， 这 里 就 传 入 该 表 的 名 字 。 第 二 个 参数 用 于 在 未 指定 添加 
数据 的 情况 下 给 某 些 可 为 空 的 列 上 自动 赋值 NvLL， 一 般 我 们 用 不 到 这 个 功 
能 ， 直 接 传 入 nulL1l 即 可 。 第 三 个 参数 是 一 个 contentvalues 对 象 ， 它 提供 














了 一 系列 的 put() 方 法 重 载 ， 用 于 辐 contentvalues 中 添加 数据 ， 只 需要 
将 表 中 的 每 个 列 名 以 及 相应 的 竺 添加 数据 传 入 即 可 。 


介绍 完了 基本 用 法 ， 接 下 来 还 是 让 我 们 通过 例子 的 方式 来 杀身 体验 一 下 
如 何 添加 数据 吧 。 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
> 





<Button 
android:id="@+id/add_data" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Add data" 


-> 
</LinearLayout> 








可 以 看 到 ， 我 们 在 布局 文件 中 又 新 增 了 一 个 按钮 ， 稍 后 就 会 在 这 个 按钮 
， 人 应 加 数据 的 逻辑 。 接 着 修改 MainActivity 中 的 代码 ， 
0 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
private MyDatabaseHelper dbHelper; 


@Ooverride 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity main); 
dbHelper = new MyDatabaseHelper(this, "BookStore.db", null, 2); 


Button addData = (Button) findViewById(R.id.add_ data); 
addData.setOonClickListener(new View.OnClickListener() { 
@override 
public void onClick(View v) { 
SQLiteDatabase db = dbHelper .getwritableDatabase(); 
ContentValues values = new ContentValues(); 
// 开始 组 装 第 一 条 数据 
values.put("name", "The Da Vinci Code"); 
values.put("author", "Dan Brown"); 
values.put("pages", 454); 
values.put("price", 16.96); 
db.insert("Book"，null，values); // 插入 第 一 条 数据 
values.clear(); 
// 开始 组 装 第 二 条 数据 
values.put("name", "The Lost Symbol") ， 
values.put("author", "Dan Brown"); 
values.put("pages", 510); 
values.put("price", 19.95); 
db.insert("Book"，null，values); // 插入 第 二 条 数据 


在 添加 数据 按钮 的 点 击 事件 里 面 ， 我 们 先 获取 到 了 seQLiteDatabase 对 

象 ， 然 后 使 用 contentvalues 来 对 要 添加 的 数据 进行 组 装 。 如 果 你 比较 
细心 的 话 应 该 会 发 现 ， 这 里 只 对 Book 表 里 其 中 四 列 的 数据 进行 了 组 装 ， 
id 那 一 列 并 没 给 它 赋 值 。 这 是 因为 在 前 面 创建 表 的 时 候 ， 我 们 束 将 id 列 


设置 为 自 增 长 了 ， 它 的 值 会 在 入 库 的 时 候 目 动 生成 ， 所 以 不 需要 手动 给 
它 赋 值 了 。 接 下 来 调用 了 insert() 方 法 将 数据 添加 到 表 当 中 ， 注 意 这 里 
我 们 实际 上 添加 了 两 条 数据 ， 上 述 代码 中 使 用 contentvalues 分 别 组 装 
了 两 次 不 同 的 内 容 ， 并 调用 了 两 次 insert() 方 法 。 

好 了 ， 现 在 可 以 重新 运行 一 下 程序 了 ， 界 面 如 图 6.22 所 示 。 
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DatabaseTest 


CREATE DATABASE 


ADD DATA 








图 6.22 ”加 入 添加 数据 按钮 


点 击 一 下 Add data 按 钮 ， 此 时 两 条 数据 应 该 都 已 经 添加 成 功 了 ， 不 过 为 
了 证 实 一 下 ， 我 们 还 是 打开 BookStore.db 数 据 库 瞧 一 上 歇 。 输 入 SQL 查 询 
语句 select * from Book;， 结 果 如 图 6.23 所 示 。 








sqlite> select x¥x from Book; 
select 关 from Book; 
i!iDan Brown !16.961454!The Da Vinci Code 


21Dan Brown 1l9.95 15101The Lost Symbhol 
sqlite> 








图 6.23 ”查看 添加 的 数据 
Ee 
a 





6.4.4 更 新 数据 


学 习 完了 如 何 辣 表 中 添加 数据 ， 接 下 来 我 们 看 看 怎样 才能 修改 表 中 己 有 

的 数据 。sQLiteDatabase 中 也 提供 了 一 个 非常 好 用 的 update() 方 法 ， 用 

于 对 数据 进行 更 新 ， 这 个 方法 接收 4 个 参数 ， 第 一 个 参数 和 insert() 方 

法 一 样 ， 也 是 表 名 ， 在 这 里 指定 去 更 新 哪 张 表 里 的 数据 。 第 二 个 参数 

是 contentvalues 对 象 ， 芭 把 更 新 数据 在 这 里 组 装 进去 。 第 三 、 第 四 个 

ee 行 或 某 几 行 中 的 数据 ， 不 指 定 的 话 暑 认 就 是 更 新 
行 。 


那么 接 下 来 我 们 仍然 是 在 DatabaseTest 项 目 的 基础 上 修改 ， 看 一 下 更 新 
数据 的 具体 用 法 。 比 如 说 刚才 添加 到 数据 库 里 的 第 一 本 书 ， 由 于 过 了 畅 
销 季 ， 卖 得 不 是 很 火 了 ， 现 在 需要 通过 降低 价格 的 方式 来 吸引 更 多 的 顾 
客 ， 我 们 应 该 怎么 操作 呢 ? 首先 修改 activity_main.xml 中 的 代码 ， 如 下 
所 示 : 











mln orp ve 人 //schel android.com/apk/res/android" 
2 cal" 


布局 文件 中 的 代码 已 经 非常 简单 了 ， 就 是 添加 了 一 个 用 于 更 新 数据 的 按 





钮 。 然 后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
private MyDatabaseHelper dbHelper; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedIinstanceState); 
setContentView(R.1layout.activity main); 
dbHelper = new MyDatabaseHelper(this, "BookStore.db", null, 2); 


Button updateData = (Button) findViewById(R.id.update_data); 
updateData.setOnclickListener(new View.OnClickListener() { 
@override 
public void onClick(View v) { 
SQLiteDatabase db = dbHelper .getwritableDatabase(); 
ContentValues values = new ContentValues(); 
values.put("price", 10.99); 
db.update("Book", values, "name = ?", new String[] { "The Da Vinci 
Code" }); 





这 里 在 更 新 数据 按钮 的 点 击 事 件 里 甸 构建 了 一 个 contentvalues 对 象 ) 
并 且 只 给 它 指 定 了 一 组 数据 ， 说 明 我 们 只 是 想 把 价格 这 一 列 的 数据 更 新 
成 10.99。 然 后 调用 了 SsQLiteDatabase 的 update() 方 法 去 执行 具体 的 更 新 
操作 ， 可 以 看 到 ， 这 里 使 用 了 第 三 、 第 四 个 参数 来 指定 具体 更 新 哪 几 
行 。 第 三 个 参数 对 应 的 是 SQL 语句 的 where 部 分 ， 表 示 更 新 所 有 name 等 
于 ?的 行 ， 而 ?是 一 个 占 位 符 ， 可 以 通过 第 四 个 参数 提供 的 一 个 字符 串 数 
组 为 第 三 个 参数 中 的 每 个 占 位 符 指 定 相应 的 内 容 。 因 此 上 述 代 码 想 表 达 
的 意图 是 将 名 字 是 The Da Vinci Code 的 这 本 书 的 价格 改 成 10.99。 


现在 重新 运行 一 下 程序 ， 界 面 如 图 6.24 所 示 。 
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DatabaseTest 


CREATE DATABASE 


ADD DATA 


UPDATE DATA 








图 6.24 加 入 更 新 数据 按钮 


点 击 一 下 Update data 按 钮 后 ， 再 次 输入 查询 语句 查看 表 中 的 数据 情况 ， 
结果 如 图 6.25 所 示 。 











ma CWindows\s 


sqlite> select x from Book; 

select x from Book; 

1iDan Brown1lgo.99 14541The Da Vinci Code 
21Dan Brown!19.95 !5101The Lost Symbol 
sqlite> 





图 6.25 ”查看 更 新 后 的 数据 


可 以 看 到 ，The Da Vinci Code 这 本 书 的 价格 已 经 被 成 功 改 为 10.99 了 。 
6.4.5 ”删除 数据 


怎么 样 ? 添加 和 更 新 数据 的 功能 都 还 挺 简单 的 吧 ， 代 码 也 不 多 ， 理 解 起 
那么 我 们 要 马不停蹄 地 开始 学 习 下 一 种 操作 了 ， 即 从 表 中 删 
除数 据 。 


删除 数据 对 你 来 说 应 该 就 更 简单 了 ， 因 为 它 所 需要 用 到 的 知识 点 你 全 部 
CT sQLiteDatabase 中 提供 了 一 个 delete() 方 法 ， 专门 用 于 删 
除数 据 ， 这 个 方法 接收 3 个 参数 ， 第 一 个 参数 仍然 是 表 名 ， 这 个 已 经 没 
什么 好 说 的 了 ， 第 二 、 第 三 个 参数 又 是 用 于 约束 删除 某 一 行 或 某 几 行 的 
数据 ， 不 指定 的 话 默认 就 是 删除 所 有 行 。 


是 不 是 理解 起 来 很 轻松 了 ? 那 我 们 就 继续 动手 实践 吧 ， 修 改 
activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
> 

















<Button 
android:id="@+id/delete_data" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Delete data" 
/> 
</LinearLayout> 





仍然 是 在 布局 文件 中 添加 了 一 个 按钮 ， 用 于 删除 数据 。 然 后 修改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
private MyDatabaseHelper dbHelper; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity_main); 
dbHelper = new MyDatabaseHelper(this, "BookStore.db", null, 2); 


Button deleteButton = (Button) findViewById(R.id.delete data); 
deleteButton.setonCclickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
SQLiteDatabase db = dbHelper .getwritableDatabase(); 
db.delete("Book", "pages > ?", new String[] { "500" }); 
}); 


可 以 看 到 ， 我 们 在 删除 按钮 的 点 击 事件 里 指明 去 删除 Book 表 中 的 数据 ， 
并 且 通 过 第 二 、 第 三 个 参数 来 指定 仅 删 除 那 些 页 数 超过 500 页 的 书 。 当 
然 这 个 需求 很 奇怪 ， 这 里 也 仅仅 是 为 了 做 个 测试 。 你 可 以 先 查 看 一 下 当 
前 Book 表 里 的 数据 ， 其 中 The Lost Symbol 这 本 书 的 页 数 超过 了 500 页 ， 
也 就 是 说 当 我 们 点 击 删除 按钮 时 ， 这 条 记录 应 该 会 被 删除 掉 。 


现在 重新 运行 一 下 程序 ， 界 面 如 图 6.26 所 示 。 





DatabaseTest 


CREATE DATABASE 


ADD DATA 


UPDATE DATA 


DELETE DATA 








图 6.26 ”加 入 删除 数据 按钮 


扩 击 一 下 Delete data 按钮 后 ， 再 次 输入 得 询 语 名 得 看 表 中 的 数据 情况 ， 
结果 如 图 6.27 所 示 。 











sqlite> select ¥x from Book; 
select ¥x from Book; 


1!iDan Brown il109.99 14541The Da Vinci Code 
sqlite> 





图 6.27 查看 删除 后 的 数据 
6.4.6 ”查询 数据 


终于 到 了 最 后 一 种 操作 了 ， 掌 握 了 查询 数据 的 方法 之 后 ， 你 就 将 数据 库 
的 CRUD 操 作 全 部 学 完了 。 不 过 千 万 不 要 因此 而 放松 ， 因 为 查询 数据 是 
CRUD 中 最 复杂 的 一 种 操作 。 


我 们 都 知道 SQL 的 全 称 是 Structured Query Language， 翻 译 成 中 文 就 是 结 
构 化 查询 语言 。 它 的 大 部 功能 都 体现 在 “ 查 ” 这 个 字 上 的 ， 而 “增删 改 * 只 
是 其 中 的 一 小 部 分 功能 。 由 于 SQL 查 询 涉 及 的 内 容 实在 是 太 多 了 ， 因 此 
在 这 里 我 不 准备 对 它 展 开 来 讲解 ， 而 是 只 会 介绍 Android 上 的 查询 功 

能 。 如 果 你 对 SQL 语言 非常 感 兴趣 ， 可 以 找 一 本 专门 介绍 SQL 的 书 进行 


学 习 。 


相信 你 已 经 猜 到 了 ，SQLiteDatabase 中 还 提供 了 一 个 query() 方 法 用 于 对 
数据 进行 查询 。 这 个 方法 的 参数 非常 复杂 ， 最 短 的 一 个 方法 重 载 也 需要 
传 入 7 个 参数 。 那 我 们 束 先 来 看 一 下 这 7 个 参数 各 目的 含义 吧 。 第 一 个 参 
数 不 用 说 ， 当 然 还 是 表 名 ， 表 示 我 们 希望 从 哪 张 表 中 查询 数据 。 第 二 个 
参数 用 于 指定 去 查询 哪 几 列 ， 如 果 不 指 定 则 默认 查询 所 有 列 。 第 三 、 第 
四 个 参数 用 于 约束 查询 某 一 行 或 菜 几 行 的 数据 ， 不 指定 则 默认 查询 所 有 
行 的 数据 。 第 五 个 参数 用 于 指定 需要 去 group by 的 列 ， 不 指定 则 表示 不 
对 查询 结果 进行 group by 操作 。 第 六 个 参数 用 于 对 group by 之 后 的 数据 进 
行进 一 步 的 过 滤 ， 不 指定 则 表示 不 进行 过 滤 。 第 七 个 参数 用 于 指定 查询 
结果 的 排序 方式 ， 不 指定 则 表示 使 用 默认 的 排序 方式 。 更 多 详细 的 内 容 
可 以 参考 下 表 。 其 他 几 个 query() 方 法 的 重 载 其 实 也 大 同 小 异 ， 你 可 以 
目 己 去 研究 一 下 ， 这 里 就 不 再 进行 介绍 了 。 
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虽然 guery() 方 法 的 参数 非常 多 ， 但 是 不 要 对 它 产生 其 恨 ， 因 为 我 们 不 
必 为 每 条 查询 语句 都 指定 所 有 的 参数 ， 多 数 情 况 下 只 需要 传 入 少数 几 个 
参数 就 可 以 完成 得 询 操作 了 。 调 用 query() 方 法 后 会 返回 一 个 cursor 对 
象 ， 查 询 到 的 所 有 数据 都 将 从 这 个 对 象 中 取出 。 


下 面 还 是 让 我 们 通过 例子 的 方式 来 体验 一 下 查询 数据 的 具体 用 法 ， 修 改 
activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 





<Button 
android:id="@+id/query_data" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Query data" 
i 
</LinearLayout> 


这 个 已 经 没什么 好 说 的 了 ， 添 加 了 一 个 按钮 用 于 查询 数据 。 然 后 修改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
private MyDatabaseHelper dbHelper; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceSstate); 
setContentView(R.1layout.activity main); 
dbHelper = new MyDatabaseHelper(this, "BookStore.db", null, 2); 


Button queryButton = (Button) findViewById(R.id.query_data); 
queryButton.setonCclickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
SQLiteDatabase db = dbHelper .getwritableDatabase(); 
// 查询 Book 表 中 所 有 的 数据 


ursor cursor = db.query("Book", null, null, null, null, null, null); 
if (cursor.moveToFirst()) { 


String name (cursor .getCcolumnIndex 
"name" ) ) 

String author = cursor.getString(cursor .getColumnIndex 
("author")); 

int pages = cursor .getInt(cursor.getColumnIndex("pages")); 

double price = cursor.getDouble(cursor.getCcolumnIndex 
("price")) 

Log.d("MainActivity "book name ame) 

Log.d("MainActivity "book auth thor) 

Log.d("MainActivity "book pag pages) 

Log.d("MainActivity "book pr p 

} while (cursor. eToNext()) 
c or.close() 
} 
}); 
省 





可 以 看 到 ， 我 们 首先 在 查询 按钮 的 点 击 事件 里 面 调用 了 SQLiteDatabase 
的 query() 方 法 去 查询 数据 。 这 里 的 query() 方 法 非常 简单 ， 只 是 使 用 了 
第 一 个 参数 指明 去 查询 Book 表 ， 后 面 的 参数 全 部 为 nu11。 这 就 表示 希望 
查询 这 张 表 中 的 所 有 数据 ， 虽 然 这 张 表 中 目前 只 剩 下 一 条 数据 了 。 碍 询 
完 之 后 就 得 到 了 一 个 cursor 对 象 ， 接 着 我 们 调用 它 的 moveToFirst() 方 法 
将 数据 的 指针 移动 到 第 一 行 的 位 置 ， 然 后 进入 了 一 个 循环 当中 ， 去 裔 历 
查询 到 的 每 一 行 数据 。 在 这 个 循环 中 可 以 通过 cursor 的 
getcolumnIndex() 方 法 获取 到 某 一 列 在 表 中 对 应 的 位 置 索 引 ， 然 后 将 这 
个 索引 传 入 到 相应 的 取 值 方法 中 ， 束 可 以 得 到 从 数据 库 中 读 取 到 的 数据 
了 。 接 着 我 们 使 用 Log 的 方式 将 取出 的 数据 打印 出 来 ， 借 此 来 检查 一 下 
读 取 工作 有 没有 成 功 完成 。 最 后 别 忘 了 调用 close() 方 法 来 关闭 


Cursor。 


好 了 ， 现 在 再 次 重新 运行 程序 ， 界 面 如 图 6.28 所 示 。 
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图 6.28 ”加 入 查询 数据 按钮 


反击 一 下 Query data 按钮 后 ， 得 看 logcat 的 打印 内 容 ， 结 果 如 图 6.29 所 
未 。 
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com. example. databasetest D/MainActivity: book name is The Da Vinci Code 








com. example. databasetest D/MainActivity: book author is Dan Brown 
com. example. databasetest D/MainActivity: book pages is 454 


com. example. databasetest D/MainActivity: book price is 10.99 


图 6.29 打印 查询 到 的 数据 


可 以 看 到 ， 这 里 已 经 将 Book 表 中 唯一 的 一 条 数据 成 功 地 读 取出 来 了 。 


当然 这 个 例子 只 是 对 查询 数据 的 用 法 进行 了 最 简单 的 示范 ， 在 真正 的 项 
目 中 你 可 能 会 遇 到 比 这 要 复杂 得 多 的 碍 询 功能 ， 更 多 高 级 的 用 法 还 需要 
你 自己 去 慢 慢 摸索 ， 毕 葛 query() 方 法 中 还 有 那么 多 的 参数 我 们 都 还 没 

用 到 呢 。 


6.4.7 ”使 用 SQL 操作 数据 库 


虽然 Android 已 经 给 我 们 提供 了 很 多 非常 方便 的 API 用 于 操作 数据 库 ， 不 
过 总 会 有 一 些 人 不 习惯 去 使 用 这 些 辅助 性 的 方法 ， 而 是 更 加 青睐 于 直接 
使 用 SQL 来 操作 数据 库 。 这 种 人 一 般 都 属于 SQL 大 牛 ， 如 果 你 也 是 其 中 
之 一 的 话 ， 那 么 茶 嘉 ，Android 充 分 考虑 到 了 你 们 的 编程 习惯 ， 同 样 提 
供 了 一 系列 的 方法 ， 使 得 可 以 直接 通过 SQL 来 操作 数据 库 。 


下 面 我 就 来 简略 演示 一 下 ， 如 何 直接 使 用 SQL 来 完成 前 面 几 小 节 中 学 过 
的 CRUD 操 作 。 











。 添加 数据 的 方法 如 下 : 


db .execSQL("insert into Book (name, author, pages, price) values(?, ?, ?, ?2)", 
new String[] { "The Da Vinci Code", "Dan Brown", "454", "16.96" }); 

db .execSQL("insert into Book (name, author, pages, price) values(?, ?, ?, ?2)", 
new String[] { "The Lost Symbol", "Dan Brown", "510", "19.95" }); 


。 更 新 数据 的 方法 如 下 : 


db .execSQL("update Book set price = ? where name = ?", new String[] { "10.99", "The Da Vinci Code" }); 


。 删除 数据 的 方法 如 下 : 


db .execSQL("delete from Book where pages > ?", new String[] { "500" }); 


。 碍 询 数据 的 方法 如 下 : 


db .rawQuery("Sselect * from Book", null); 


可 以 看 到 ， 除 了 查询 数据 的 时 候 调 用 的 是 SQLiteDatabase 的 rawQuery() 
方法 ， 其 他 的 操作 都 是 调用 的 execsQL() 方 法 。 以 上 演示 的 几 种 方式 ， 
执行 结果 会 和 前 面 几 小 市 中 我 们 学 习 的 CRUD 操 作 的 结果 完全 相同 ， 选 
择 使 用 哪 一 种 方式 束 看 你 个 人 的 喜好 了 。 


6.5 ”使 用 LitePal 操 作 数 据 库 


上 一 节 中 我 们 学 习 了 使 用 SQLiteDatabase 来 操作 SQLite 数 据 库 的 方法 ， 
你 觉得 好 用 吗 ? 每 个 人 的 回答 可 能 会 不 一 样 。 但 我 相信 ， 等 学 完了 本 节 
的 内 容 之 后 ， 你 将 再 也 不 想 去 磁 SQLiteDatabase 了 。 到 底 是 什么 东西 这 
么 神奇 ? 新 建 一 个 LitePalTest 项 目 ， 然 后 开始 我 们 本 节 的 学 习 之 旅 吧 。 





6.5.1 LitePal 简 介 


如 今 ，Android 的 学 习 环境 比 起 我 当年 学 习 的 时 候 已 经 好 太 多 了 。 当 时 
国内 做 Android 的 人 并 不 多 ， 各 种 学 习 资 料 也 比较 欠缺 ， 一 个 项 目 中 几 
乎 所 有 的 功能 都 要 完全 靠 上 自己 从 头 来 实现 ， 开 发 效率 之 低下 可 想 而 知 。 


而 现在 开源 的 热 湖 让 所有 Android 开 发 者 都 大 大 受益 ，GitHub 上面 有 成 
百 上 千 的 优秀 Android 开 源 项 目 ， 很 多 之 前 我 们 要 写 很 久 才能 实现 的 功 
能 ， 使 用 开源 库 可 能 短 短 几 分 钟 就 能 实现 了 。 除 此 之 外 ， 公 司 里 的 代码 
非常 强调 稳定 性 ， 而 我 们 自己 写 出 的 代码 往往 越 复 杂 就 越 容 易 出 问题 。 
相反 ， 开 源 项 目的 代码 都 是 经 过 时 间 验 证 的 ， 通 常 比 我 们 自己 的 代码 要 
稳定 得 多 。 因 此 ， 现 在 有 很 多 公司 为 了 追求 开发 效率 以 及 项 目 稳 定性 ， 
都 会 选择 使 用 开源 库 。 


本 书 中 我 们 将 会 学 习 多 个 开源 库 的 使 用 方法 ， 而 现在 你 将 正式 开始 接触 
第 一 个 开源 库 LitePal 。 


LitePal 是 一 球 开 源 的 Android 数 据 库 框架 ， 它 采用 了 对 象 天 系 映射 
CORM) 的 模式 ， 并 将 我 们 平时 开发 最 常用 到 的 一 些 数 据 库 功 能 进行 
了 封装 ， 使 得 不 用 编写 一 行 SQL 语 句 就 可 以 完成 各 种 建 表 和 增删 改 查 的 
操作 。LitePal 的 项 目 主 页 上 也 有 详细 的 使 用 文档 ， 地 址 


日 


十: https:/github.com/LitePalFramework/LitePal 。 
6.5.2 ”配置 LitePal 
那么 怎样 才能 在 项 目 中 使 用 开源 库 呢 ?过 去 的 方式 比较 复杂 ， 通 常 需 要 


下 载 开 源 库 的 Jar 包 或 者 源码 ， 然 后 再 集成 到 我 们 的 项 目 当 中 。 而 现在 就 
简单 得 多 了 ， 大 多 数 的 开源 项 目 部 会 将 版 本 提交 到 jcenter 上 ， 我 们 只 需 























要 在 app/build.gradle 文 件 中 声明 该 开源 库 的 引用 就 可 以 了 。 


此 ， 要 使 用 LitePal 的 第 一 步 ， 束 是 编辑 app/build.gradle 文 件 ， 在 
dependencies 闭 包 中 添加 如 下 内 容 : 


dependencies { 
compile fileTree(dir: libs includes. "< 1ar .i 
compile 'com.android. support: appcompat-v7:23.2.0"' 
testcompile "junit:junit:4.12" 
compile 'org.litepal.android:core:1.4.1" 











添加 的 这 一 行 声明 中 ， 前 面部 分 古 固 定 的 ， 最 后 的 1.4.1 是 版 本 号 的 意 
思 ， 最 新 的 版 本 号 可 以 到 LitePal 的 项 目 主 页 上 去 查看 。 


这 样 我 们 就 把 LitePal 成 功 引 入 到 当前 项 目 中 了 ， 接 下 来 需要 配置 
litepal.xml 文 件 。 右 击 app/src/main 目 录 New Directory， 创 建 一 个 
assets 目 录 ， 然 后 在 assets 目 录 下 再 新 建 一 个 ]itepal.xml 文 件 ， 接 着 编辑 
litepal.xml 文 件 中 的 内 容 ， 如 下 所 示 : 


<?xml1 version="1.0" encoding="utf-8"?> 
<litepal> 
<dbname value="BookStore" ></dbname> 











<version value="1" ></version> 


<list> 
</list> 
</litepal> 


其 中 ，<dbname> 标 签 用 于 指定 数据 库 名 ，<version> 标 签 用 于 指定 数据 库 
版 本 号 ， <1ist> 标 签 用 于 指定 所 有 的 映射 模型 ， 我 们 稍 后 就 会 用 到 。 


最 后 还 需要 再 配置 一 下 LitePalApplication， 修 改 AndroidManifest.xml 中 
的 代码 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 

package="com.example.litepaltest"> 

<application 
android:name="org.litepal.LitepPalApplication" 
android:allowBackup="true 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 





</application> 
</manifest> 


这 里 我 们 将 项 目的 application 配 置 
为 org.1litepal.LitePalApplication， 这 样 才能 让 LitePal 的 所 有 功能 都 


本 以 证 全 [Ee 天 于 application 的 作用 ， 我 们 之 前 并 没有 进行 过 详细 
的 讲解 ， 现 在 你 只 需要 知道 必须 这 么 写 就 行 了 ， 我 们 将 会 在 第 13 章 中 学 
习 application 的 更 多 内 容 。 


现在 LitePal 的 配置 工作 已 经 全 部 结束 了 ， 下 面 我 们 开始 正式 使 用 它 吧 。 
6.5.3 ”创建 和 升级 数据 库 


我 们 之 前 创建 数据 库 是 通过 自 定 义 一 个 类 继承 自 SQLiteOpenHelper， 然 
后 在 oncreate() 方 法 中 编写 建 表 语 句 来 实现 的 ， 而 使 用 LitePal 束 不 用 再 
这 么 抹 烦 了 。 本 市 中 我 们 会 使 用 LitePal 来 逐一 完成 上 一 市 中 所 学 的 所 有 
功能 ， 以 此 来 对 比 它们 之 间 的 差距 ， 那 么 为 了 方便 测试 ， 我 们 先 将 
activity_main.xml 布 局 文件 从 DatabaseTest 项 目 复制 到 LitePalTest 项 目 中 
来 ， 














刚才 在 介绍 的 时 候 已 经 说 过 ，LitePal 采 取 的 是 对 象 关 系 映射 (ORM) 的 
模式 ， 那 么 什么 是 对 象 关 系 映射 呢 ? 简单 点 说 ， 我 们 使 用 的 编程 语言 是 
面向 对 象 语 言 ， 而 使 用 的 数据 库 则 是 关系 型 数据 库 ， 那 么 将 面向 对 象 的 
言 和 面向 关系 的 数据 库 之 间 建 立 一 种 映射 关系 ， 这 就 是 对 象 关系 映射 


不 过 你 可 千 万 不 要 小 看 对 象 关 系 映射 模式 ， 它 赋予 了 我 们 一 个 强大 的 功 
能 ， 束 是 可 以 用 面 癌 对 象 的 思维 来 操作 数据 库 ， 而 不 用 再 和 SQL 语句 打 
交道 了 ， 不 信 的 话 我 们 现在 就 来 体验 一 下 。 比 如 在 6.4.1 小 节 中 ， 为 了 创 
建 一 张 Book 表 ， 需 要 先 分 析 表 中 应 该 包含 哪些 列 ， 然 后 再 编写 出 一 条 建 
表 语 句 ， 最 后 在 自 定 义 的 SQLiteOpenHelper 中 去 执行 这 条 建 表 语 句 。 但 
是 使 用 LitePal， 你 就 可 以 用 面向 对 象 的 思维 来 实现 同样 的 功能 了 ， 定 义 
一 个 Book 类 ， 代 码 如 下 所 示 : 


public class Book { 











vate int id; 
vate String author; 


vate double price; 


TT 中 of + 


vate int pages; 

vate String name 

ublic int getId() { 
return id; 

ublic void setId(int id) { 

this.id = id; 


p 
p 
p 
p 
p 
p 
于 
p 
. 
public String getAuthor() { 
return author; 


public 0 setAuthor(String author) { 
author = author; 
} 


public double getPrice() { 
return price; 

} 

public void es price) { 
this.price = pri 


public int getPages() { 
return pages; 

} 

public ws a pages) { 
this.pages = pag 


public String getName() { 
return name; 


} 


public void seen (SHrA09 name) { 
this.name = name 


} 


这 是 一 个 典型 的 Java bean， 在 Book 类 中 我 们 定义 了 
id、author、price、 1 name 这 几 个 字段 ， 并 生成 了 相应 的 getter 
和 setter 方 法 。1 相 应 你 已 经 能 猿 到 了 ，Book 类 就 会 对 应 数据 库 中 的 
Book 表 ， 而 类 中 的 每 一 个 字段 分 别 对 应 了 表 中 的 每 一 个 列 ， 这 就 是 对 象 
关系 映射 最 直观 的 体验 ， 现 在 你 能 够 理解 得 更 加 清楚 了 吧 。 


1 生成 getter 和 setter 方 人 式 是 ， 先 将 类 中 的 字段 定义 好 ， 然 后 按 下 Alt + Insert 键 (Mac 系统 是 command + N) ， 在 弹出 菜单 中 选择 Getter and Setter， 接 着 使 
Sh 健将 所 有 字段 都 选中 点 击 OK。 



































接 下 来 我 们 还 需要 将 Book 类 添加 到 映射 模型 列表 当中 ， 修 改 litepal.xml 
中 的 代码 ， 如 下 所 示 : 


<litepal> 
<dbname value="BookStore" ></dbname> 


<version value="1" ></version> 


<list> 
<mapping class="com.example.litepaltest .Book"></mapping> 

</list> 

</litepal> 


这 里 使 用 <mapping> 标 签 来 声明 我 们 要 配置 的 映射 模型 类 ， 注 意 一 定 要 
使 用 完整 的 类 名 。 不 管 有 多 少 模型 类 需要 映射 ， 都 使 用 同样 的 方式 配置 
在 <list> 标 签 下 即 可 。 


没 错 ， 这 样 就 己 经 把 所 有 工作 都 完成 了 ， 现 在 只 要 进行 任意 一 次 数据 库 
的 操作 ，BookStore.db 数 据 库 应 该 束 会 自动 创建 出 来 。 那 么 我 们 修改 








MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity main); 
Button createDatabase = (Button) findViewById(R.id.create database); 
createDatabase.setOonClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
LitePal.getDatabase( ); 





其 中 ， 调 用 LitePal.getDatabase() 方 法 就 是 一 次 最 简 持 的 数据 库 操作 ， 
只 要 点 击 一 下 按钮 ， 数 据 库 就 会 自动 创建 完成 了 。 运 行 一 下 程序 ， 然 后 
点 击 Create database 按钮 ， 接 着 通过 adb shell 查 看 一 下 数据 库 创建 情 
况 ， 如 图 6.30 所 示 。 








root@ygeneric_x86:/data/data/com.example.litepaltest # cd databases 


root@ygeneric_x86:/data/data/com.example.litepaltest/databases # ls 
BookStore .db 

BookStore .dbh—journal 
root@ygeneric_x86:/data/data/com.example.litepaltest/databases # 





图 6.30 ”但 看 数据 库 文件 


非常 棱 ! 数据 库 文 件 已 经 创建 成 功 了 。 接 下 来 我 们 使 用 sqlite3 命 令 打 
开 BookStore.db 文 件 ， 然 后 再 使 用 .schema 命 令 来 查看 建 表 语句 ， 如 图 
6.31 所 示 。 


ee 了 一 oR 
Ci. 管 考 另 人 AU 


sqlite> -Schema 

CREATE TABLE android_metadata locale TEXTy>; 

CREATE TABLE table_schema id integer primary key autoincrement.name text, type 
integer>; 

CREATE TABLE book 《id integer primary key autoincrement.author text, name text. 
pages integer,. price real)’; 

sqlite> 





图 6.31 查看 建 表 语句 


可 以 看 到 ) 这 里 有 3 张 表 的 建 表 语 句 ) 其 中 and roid_metadata 表 仍然 不 用 
管 ，table_schema 表 是 LitePal 内 部 使 用 的 ， 我 们 也 可 以 直接 忽视 ，book 
表 束 是 根据 我 们 定义 的 Book 类 以 及 类 中 的 字段 来 自动 生成 的 了 。 


怎么 样 ， 是 不 是 很 神奇 ? 但 不 用 太 吃 惊 ， 因 为 更 加 神奇 的 还 在 后 面 呢 。 
6.4.2 节 中 我 们 体验 了 使 用 SQLiteOpenHelper 来 升级 数据 库 的 方式 ， 虽 说 
功能 是 实现 了 ， 但 你 有 没有 发 现 一 个 问题 ， 就 是 升级 数据 库 的 时 候 我 们 
需要 先 把 之 前 的 表 drop 掉 ， 然 后 再 重新 创建 才 行 。 这 其 实 是 一 个 非常 严 
重 的 问题 ， 因 为 这 样 会 造成 数据 丢失 ， 每 当 升 级 一 次 数据 库 ， 之 前 表 中 
的 数据 就 全 没 了 。 

当然 如 果 你 是 非常 有 经 验 的 程序 员 ， 也 可 以 通过 复杂 的 逻辑 控制 来 避免 
这 种 情况 ， 但 是 维护 成 本 很 高 。 而 有 了 LitePal， 这 些 就 都 不 再 是 问题 

了 ， 使 用 LitePal 来 升级 数据 库 非 常 非常 简单 ， 你 完全 不 用 思考 任何 的 逻 
辑 ， 只 需要 改 你 想 改 的 任何 内 容 ， 然 后 将 版 本 号 加 1 就 行 了 。 


比如 我 们 想 要 向 Book 表 中 添加 一 个 press (出 版 社 ) 列 ， 直 接 修改 eook 类 
中 的 代码 ， 添 加 一 个 press 字 段 即 可 ， 如 下 所 示 : 


public class Book { 



































private String press; 


public String getPress() { 
return press; 

J 

public void setPress(String press) { 
his.press = press; 


} 


与 此 同时 ， 我 们 还 想 再 添加 一 张 Category 表 ， 那 么 只 需要 新 建 一 
个 category 类 就 可 以 了 ， 代 码 如 下 所 示 : 


public class Category { 
private int id; 
private String categoryName; 
private int categoryCode; 
public void setId(int id) { 


this.id = id， 


public void setCategoryName(String categoryName) { 
this.categoryName = categoryName; 


public void setCategoryCode(int categoryCode) { 
this.categoryCode = categoryCode; 


} 





改 冠 了 所 有 我 们 想 改 的 东西 ， 只 需要 记得 将 版 本 号 加 1 惑 行 了 。 当 然 由 
于 这 里 还 添加 了 一 个 新 的 模型 类 ， 因 此 也 需要 将 它 添加 到 映射 模型 列表 
中 。 修 改 litepal.xml 中 的 代码 ， 如 下 所 示 : 


<litepal> 
<dbname value="BookStore" ></dbname> 





<version value="2" ></version> 


<list> 
<mapping class="com.example.litepaltest .Book"></mapping> 
<mapping class="com.example.litepaltest.Category"></mapping> 
/list> 
</litepal> 





现在 重新 运行 一 下 程序 ， 然 后 点 击 Create database 按钮 ， 再 查看 一 下 最 
新 的 建 表 语 句 ， 结 果 如 图 6.32 所 示 。 








E 管理 员 : C:\Windows\system32\cmd.exe - adb sh 


sqlite> -Schema 

CREATE TABLE android_metadata Clocale TEXT»; 

CREATE TABLE table_schema Cid integer primary key autoinckement .name text, type 
integer>; 

CREATE TABLE book (Cid integer primary key autoincrement.author text, name text。 


pages integer, price real, press text>»; 

CREATE TABLE category id integer primary key autoincrement .categorycode integer 
»- Categoryname text>; 

sqlite> 








图 6.32 升级 数据 库 后 的 建 表 语句 


可 以 看 到 ，book 表 中 新 增 了 一 个 press 列 ，category 表 也 创建 成 功 了 ， 当 
然 LitePal 还 上 自动 帮 我 们 做 了 一 项 非常 重要 的 工作 ， 就 是 保留 之 前 表 中 的 
所 有 数据 ， 这 样 就 再 也 不 用 担心 数据 丢失 的 问题 了 。 


6.5.4 ”使 用 LitePal 添 加 数据 


体验 了 使 用 LitePal 来 创建 和 升级 数据 库 ， 是 不 是 感觉 已 经 有 一 些小 震撼 
了 了 昵 ? 不 过 LitePal 所 提供 的 强大 功能 还 远 不 止 于 此 ， 接 下 来 我 们 就 学 习 
一 下 如 何 使 用 它 来 向 数据 库 的 表 中 添加 数据 吧 。 


首先 回顾 一 下 之 前 添加 数据 的 方法 ， 我 们 需要 创建 出 一 

个 contentvalues 对 象 ， 然 后 将 所 有 要 添加 的 数据 put 到 这 

个 contentvalues 对 象 当 中 ， 最 后 再 调用 SQLiteDatabase 的 insert() 方 法 
将 数据 添加 到 数据 库 表 当中 。 


而 使 用 LitePal 来 添加 数据 ， 这 些 操作 可 以 简单 到 让 你 惊叹 ! 我 们 只 需要 
创建 出 模型 类 的 实例 ， 再 将 所 有 要 存储 的 数据 设置 好 ， 最 后 调用 一 
下 save() 方 法 束 可 以 了 。 


下 面 开 始 来 动手 实现 ， 观 察 现 有 的 模型 类 ， 你 会 发 现 它 们 都 是 没有 继承 
结构 的 。 没 错 ， 因 为 LitePal 进 行 表 管理 操作 时 不 需要 模型 类 有 任何 的 继 
承 结构 ， 但 是 进行 CRUD 操 作 时 束 不 行 了 ， 必 须要 继承 自 Datasupport 类 
ee 吉 构 给 加 上 。 修 改 Book 类 中 的 代码 ， 
0 下 所 示 : 


public class Book extends DataSupport { 
} 

















向 Book 表 中 添加 数据 ， 修 改 MainActivity 中 的 代码 ， 如 下 
修 \: 


public class MainActivity extends AppCompatActivity { 


@override 

pro ote ts Ee Dio nCreate(Bu Ds SavedInstanceState) { 
upe es vedIn i eSta te); 

et See Rye Ww(R. a ayout. 省 vity_main); 


Butto yaddars 人 ytto ") fi ndvie euById(R. 1 id. add_ da ta) 
addDa ta etonclic er(ne ckLi er() I 
@Ov 


. 
public void onClick(View v) { 
boo > 


SUTOSISIOm 
Oooooo0 3 


这 段 代 码 非 常 神奇 ， 我 们 来 仔细 阅读 一 下 。 在 添加 数据 按钮 的 点 击 事 件 
里 面 ， 首 先是 创建 出 了 一 个 Book 的 实例 ， 然 后 调用 Book 类 中 的 各 种 set 
方法 对 数据 进行 设置 ， 最 后 再 调用 book. save( ) 方 法 就 能 完成 数据 添加 
操作 了 。 那 么 这 个 save() 方 法 是 从 哪儿 来 的 呢 ? 当然 是 从 Datasupport 类 
中 继承 而 来 的 了 。 除了 save() 方 法 之 外 ， Datasupport 类 还 给 我 们 提供 了 
丰富 的 CRUD 方 法 ， 这 些 我 们 在 后 面 都 会 学 到 。 


现在 重新 运行 程序 ， 点 击 一 下 Add data 按钮 ， 此 时 数据 应 该 已 经 添加 成 
功 了 ， 我 们 打开 BookStore.db 数 据 库 瞧 一 瞧 。 输 入 SQL 碍 询 语句 select 
* from Book， 结 果 如 图 6.33 所 示 。 
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SQLite version 3.8.10.2 20915-05-209 18:17:19 
Enter ".help”"” for usage hints. 

sqlite> select ¥x from Book; 

1iDan Brown'iThe Da Vinci Code 1454116 .96 1Unknow 
sqlite> 





图 6.33 ”但 看 添加 的 数据 


可 以 看 到 ， 作 者 、 书 名 、 页 数 、 价 格 、 出 版 社 ， 这 些 数据 全 部 精确 无 误 
地 添加 成 功 了 。 


6.5.5 ”使 用 LitePal 更 新 数据 
学 习 完 了 如 何 使 用 LitePal 琴 加 数据 ， 接 下 来 我 们 看 看 怎样 使 用 LitePal 更 








新 数据 。 更 新 数据 要 比 添加 数据 稍微 复 森 一点， 因为 它 的 API 接 口 比较 
多 ， 这 里 我 们 只 介绍 最 常用 的 几 种 更 新 方式 。 
首先 ， 最 简单 的 一 种 更 新 方式 就 是 对 已 存储 的 对 象 重 新 设 值 ， 然 后 重新 








人 
和 对象? 








对 于 LitePal 来 说 ， 对 象 是 否 已 存储 束 是 根据 调用 model.issaved() 方 法 的 
结果 来 判断 的 ， 返 回 true 束 表示 已 存储 ， 返 回 false 束 表示 未 存储 。 那 
么 接 下 来 的 问题 就 是 ， 什 么 情况 下 会 返回 true， 什 么 情况 下 会 返回 
false 呢 ? 


实际 上 只 有 在 两 种 情况 下 model.issaved() 方 法 才 会 返回 true， 一 种 情况 
是 已 经 调用 过 model.save() 方 法 去 添加 数据 了 ， 此 时 model 会 被 认为 是 已 
存储 的 对 象 。 另 一 种 情况 是 mode1 对 象 是 通过 LitePal 提 供 的 查询 API 碍 出 
。 ， 由 于 是 从 数据 库 中 得 到 的 对 象 ， 因 此 也 会 被 认为 是 已 存储 的 对 


由 于 查询 API 我 们 暂时 还 没 学 到 ， 因 此 只 能 先 通 过 第 一 种 情况 来 进行 验 
证 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
@override 
pro ot cte ey od nCreate(Bu Boe SavedInstanceState) { 
upe Ce Te tanceState); 
eCo 站 wR 1a ayo BCtIvity Min): 


Bu tton pte Data je utton) findVi A id.update_data); 
updateData.setOnclickListener(new View ClickListener() { 


public void onClick(View v) { 
k bo Or = new Book(); 

"The Lost syn mbol"); 
Brown"); 


在 更 新 数据 按钮 的 点 击 事件 里 面 ， 我 们 先是 通过 上 一 小 节 中 学 习 的 知识 
添加 了 一 条 Book 数 据 ， 然 后 调用 setPrice() 方 法 将 这 本 书 的 价格 进行 了 
修改 ， 之 后 再 次 调用 了 save() 方 法 。 此 时 LitePal 会 发 现 当 前 的 Book 对 象 

是 已 存储 的 ， 因 此 不 会 再 癌 数 据 库 中 去 添加 一 条 新 数据 ， 而 是 会 直接 更 
新 当前 的 数据 。 


现在 重新 运行 一 下 程序 ， 然 后 点 击 Update data 按 钮 ， 我 们 再 次 输入 查询 
语句 查看 表 中 的 数据 情况 ， 结 果 如 图 6.34 所 示 。 











Enter ".help”"” for usage hints. 
sqlite> select ¥x from Book; 
i!iDan Brown!The Da Vinci Code 1454116 .96 !Unknow 


21Dan Brown!The Lost Sumhbo115101109.99 1!Unknow 
sqlite> 





图 6.34 但 看 更 新 后 的 数据 


可 以 看 到 ，Book 表 中 新 增 了 一 条 书 的 数据 ， 但 这 本 书 的 价格 并 不 是 一 开 
台 设 置 的 19.95， 而 是 10.99， 说 明 我 们 的 更 新 操作 确实 生效 了 。 


但 是 这 种 更 新 方式 只 能 对 已 存储 的 对 象 进行 操作 ， 限 制 性 比较 大 ， 接 下 
~ ] 学 局 另外 一 种 更 加 灵巧 的 更 新 方式 。 修 改 MainActivity 中 的 代 
但 ， 中 个 \: 


public class MainActivity extends AppCompatActivity { 





@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity_main); 


Button updateData = (Button) findViewById(R.id.update_data); 
updateData.setOonClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
Book book = new Book(); 
book.setPrice(14.95); 
book.setPress("Anchor"); 
book.updateAll("name = ? and author = ?", "The Lost Symbol", "Dan 
Brown"); 


可 以 看 到 ， 这 里 我 们 首先 new 出 了 一 个 Book 的 实例 ， 然 后 直接 调 

用 setPrice() 和 setPress() 方 法 来 设置 要 更 新 的 数据 ， 最 后 再 调 

用 updateA11( ) 方 法 去 执行 更 新 操作 。 注 意 updateA11() 方 法 中 可 以 指定 
一 个 条 件 约 束 ， 和 SQLiteDatabase 中 update() 方 法 的 where 参 数 部 分 有 点 
类 似 ， 但 更 加 简洁 ， 如 果 不 指 定 条 件 语 句 的 话 ， 就 表示 更 新 所 有 数据 。 
这 里 我 们 指定 将 所 有 书 名 是 The Lost Symbol 并 且 作 者 是 Dan Brown 的 书 
价格 更 新 为 14.95， 出 版 社 更 新 为 Anchor。 


现在 重新 运行 程序 并 点 击 Update data 按钮 ， 我 们 再 次 查询 一 下 表 中 的 数 
扼 情 况 ， 结 果 如 图 6.35 所 示 。 





Enter ".help”"” for usage hints. 
sqlite> select ¥x from Book; 
i!iDan Brown!The Da Vinci Code 1454116 .96 !Unknow 


21Dan BrowniThe Lost Sumhbo115109114.95 416nchor 
sqlite> 





图 6.35 再 次 查看 更 新 后 的 数据 


意料 之 中 ， 第 二 本 书 的 价格 被 更 新 成 了 14.95， 出 版 社 被 更 新 成 了 
Anchor。 怎 么 样 ? LitePal 的 更 新 API 是 不 是 明显 比 SQLiteDatabase 的 
update() 方 法 要 好 用 多 了 ? 


不 过 ， 在 使 用 updateAl1() 方 法 时 ， 还 有 一 个 非常 重要 的 知识 点 是 你 需 
要 知晓 的 ， 束 是 当 你 想 把 一 个 字段 的 值 更 新 成 默认 值 时 ， 是 不 可 以 使 用 
上 面 的 方式 来 set 数 据 的 。 我 们 都 知道 ， 在 Java 中 任何 一 种 数据 类 型 的 
字段 部 会 有 默认 值 ， 例如 int 类 型 的 默认 值 是 0，boolean 类 型 的 默认 值 
是 false，String 类 型 的 默认 值 是 nul1。 那 么 当 new 出 一 个 Book 对 象 时 ， 
II 化 成 默认 值 了 ， 比 如 说 pages 字 段 的 值 就 是 

因此 ， 如 果 我 们 想 把 数据 库 表 中 的 pages 列 更 新 成 0， 直 接 调 
eo 因为 即使 不 调用 这 行 代 码 ，pages 字 段 
本 身 也 是 0，LitePal 此 时 是 不 会 对 这 个 列 进行 更 新 的 。 对 于 所 有 想 要 将 
为 数据 更 新 成 默认 值 的 操作 ，LitePal 统 一 提供 了 一 个 setToDefault() 方 
法 ， 然 后 传 入 相应 的 列 名 就 可 以 实现 了 。 比 如 我 们 可 以 这 样 写 : 


Book book = 
book. set 
book . pda ate A11(); 


这 段 代 码 的 意思 是 ， 将 所 有 书 的 页 数 都 更 新 为 0， 因 为 updateAl1() 方 法 
中 没有 指定 约束 条 件 ， 因 此 更 新 操作 对 所 有 数据 都 生效 了 。 
6.5.6 ”使 用 LitePal 删 除数 据 
使 用 LitePal 删 除数 据 的 方式 主要 有 两 种 ， 第 一 种 比较 简单 ， 就 是 直接 调 


用 已 存储 对 象 的 delete() 方 法 就 可 以 了 ， 对 于 已 存储 对 象 的 概念 ， 我 们 
在 上 一 小 市 中 已 经 学 习 过 了 。 也 就 是 说 ， 调 用 过 save() 方 法 的 对 象 ， 或 














者 是 通过 LitePal 提 供 的 查询 API 查 出 来 的 对 象 ， 都 是 可 以 直接 使 
用 delete() 方 法 来 删除 数据 的 。 这 种 方式 比较 简单 ， 我 们 融 不 进行 代码 
演示 了 了， 下面 直接 来 看 另外 一 种 删除 数据 的 方式 。 


修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 





@override 
pr ot ete dv pao RG te (Eun se sa Vek StanceState) { 
a ner ate Elsa dIn ee estate); 
etconte Pv iew(R. 1a ayout . El vity_main); 


Bu tton ge Let el tto Sau ito n) findVi SR id.de Le _data); 
dele tton. seto nClic er(new Vie ClickLi er(){ 
ooverrige 
public ick(View v) { 
De Ge Rt oe lete eAT1( B05 Dkiclass, price < Pr. 15.) 


这 里 调用 了 patasupport .deleteAl1() 方 法 来 删除 数据 ， 其 中 

deleteAl1() 方 法 的 第 一 个 参数 用 于 指定 删除 哪 张 表 中 的 数据 ， 

Book.class 束 意味 着 删除 Book 表 中 ,后面 的 参 数 用 于 指定 约束 条 
件 ， 应 该 不 难 理解 。 那 么 这 行 代码 的 意思 就 是 ， 删 除 Book 表 中 价格 低 于 
15 的 书 ， 正 好 目前 Book 表 中 有 两 本 书 ， 一 本 价格 是 16.96， 一 本 价格 是 
14.95， 刚 好 可 以 看 出 效果 。 


现在 重新 运行 程序 ， 并 点 击 一 下 Delete data 按钮 ， 然 后 查询 表 中 的 数据 
情况 ， 如 图 6.36 所 示 。 














sqlite> select ¥ from Book; 
i1iDan Brown!The Da Vinci Code 1454116 .96 :Unknow 
sqlite> 





图 6.36 ”查看 删除 后 的 数据 
可 以 看 到 ， 价 格 低 于 15 的 那 本 书 已 经 被 删除 掉 了 。 
另外 ，deleteAl1() 方 法 如 果 不 指 定 约束 条 件 ， 就 意味 着 你 要 删除 表 中 


的 所 有 数据 ， 这 一 点 和 updateAl1() 方 法 是 比较 相似 的 。 
6.5.7 “使 用 LitePal 查 询 数据 


终于 又 到 了 最 复杂 的 查询 数据 部 分 了 ， 不 过 这 个 “最 复杂 ”只 是 相对 于 过 
去 而 言 ， 因 为 使 用 LitePal 来 查询 数据 一 点 都 不 复杂 。 我 一 直 都 认为 
LitePal 在 查询 API 方 面 的 设计 极为 人 性 化 ， 想 想 之 前 我 们 所 使 用 的 
query() 方 法 ， 宛 长 的 参数 列表 让 人 看 得 头疼 ， 即 使 多 数 参 数 都 是 用 不 
到 的 ， 也 不 得 不 传 入 nul1， 如 下 所 示 : 











像 这 样 的 代码 臣民 是 没 人 会 喜欢 的 。 为 此 LitePal 在 查询 AP 方面 做 了 非 
常 多 的 优化 ， 基 本 上 可 以 满足 绝 大 多 数 场景 的 查询 需求 ， 并 且 代 码 十 分 
整洁 ， 下 面 我 们 就 来 一 起 学 习 一 下 。 

首先 分 析 一 下 上 述 代 码 ，query() 方 法 中 使 用 了 第 一 个 参数 指明 去 查询 
Book 表 ， 后 面 的 参数 全 部 为 ul1， 这 就 表示 希 电 查询 这 张 表 中 的 所 有 数 


据 。 那 么 使 用 LitePal 如 何 完成 同样 的 功能 呢 ? 非常 简单 ， 只 需要 这 样 
有 


List<Book> books = DataSupport.findAll(Book.class); 

















怎么 样 ， 代 码 是 不 是 简单 易 懂 多 了 ? 没有 元 长 的 参数 列表 ， 只 需要 调用 
一 下 findAll1( ) 方 法 ， 然 后 通过 Book .class 参 数 指定 查询 Book 表 就 可 
以 。 男 外 ，findAl11() 方 法 的 返回 值 是 一 个 Book 类 型 的 List 集 合 ， 也 就 是 
说 ， 我 们 不 用 像 之 前 那样 再 通过 cursor 对 象 一 行 行 去 取 值 了 ，LitePal 已 
经 自动 帮 我 们 完成 了 赋值 操作 。 


下 面 通过 一 个 完整 的 例子 来 实践 一 下 吧 ， 修 改 MainActivity 中 的 代码 ， 
如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


@override 

pro ote cte ey od nCreate(Bu se a tancoStasey 不 
upe ate sa vedIn a oa 

Co te nV w(R. 1a ayout . Ct vity_main); 


Button quer 2 tton = (Butto no fi De he id. qu ory cat a) 
queryButton.seton C11 ckListener (ne ckLi er(){ 
e 


V 

和 oid 0o Dee ck(View v) { 

books = Daa or dAlT eBook Cia: 
{ 


Bo 
Bo Ok bo ok: books) 


Log.d("MainActivity", "book name is " + book.getName()); 
Log.d("MainActivity", "book author is " + book.getAuthor()); 
Log.d("MainActivity", "book pages is " + book.getPages()); 
Log.d("MainActivity", "book price is " + book.getPrice()); 
Log.d("MainActivity", "book press is " + book.getPress()); 








得 询 的 那 段 代码 刚刚 已 经 解释 过 了 ， 接 下 来 就 是 过 历 List 集 合 中 的 Book 
对 象 ， 并 将 其 中 的 信息 全 部 打印 出 来 。 下 程序 ， 点 击 
Query data 按 钮 ， 然后 查看 logcat 的 打印 内 容 ， 结 果 如 网 6.37 所 示 。 


| Verbose MC @- 














com. example. litepaltest D/MainActivity: book name is The Da Vinci Code 
com. example. litepaltest D/MainActivity: book author is Dan Brown 

com. example. litepaltest D/MainActivity: book pages is 454 

com. example. litepaltest D/MainActivity: book price is 16.96 


com. example. litepaltest D/MainActivity: book press is Unknow 
图 6.37 打印 查询 到 的 数据 


ee 一 条 数据 ， 由 此 可 见 ， 我 们 已 经 将 这 条 数据 成 功 查 询 出 
末了 。 


除了 findAl1( ) 方 法 之 外 ， LitePal 还 提供 了 很 多 其 :他 非常 有 用 的 僵 询 
API。 比 如 我 们 想 要 查询 Book 表 中 的 第 一 条 数据 束 可 以 这 样 写 : 


Book firstBook = DataSupport.findFirst(Book.class); 





查询 Book 表 中 的 最 后 一 条 数据 就 可 以 这 样 写 : 


Book lastBook = DataSsupport.findLast(Book.class); 


我 们 还 可 以 通过 连 级 查询 来 定制 更 多 的 查询 功能 。 


。 select() 方 法 用 于 指定 查询 哪 几 列 的 数据 ， 对 应 了 SQL 当中 的 


select 关 键 字 。 比 如 只 查 name 和 author 这 两 列 的 数据 ， 束 可 以 这 样 
写 : 
List<Book> books = DataSupport.select("name", "author").find(Book.class); 


where() 方 法 用 于 指定 查询 的 约束 条 件 ， 对 应 了 SQL 当 中 的 where 关 
键 字 。 比 如 只 查 页 数 大 于 400 的 数据 ， 就 可 以 这 样 写 : 


List<Book> books = DataSupport.where("pages > ?", "400").find(Book.class); 


order() 方 法 用 于 指定 结 琳 的 排序 方式 ， 对 应 了 SQL 当中 的 order by 
关键 字 。 比 如 将 碍 询 结果 按照 书 价 从 高 到 低 排 序 ， 就 可 以 这 样 写 : 


List<Book> books = DataSupport .order("price desc").find(Book.class); 











其 中 desc 表 示 降 序 排列 ，asc 或 者 不 写 表 示 升 序 排列 。 


limit() 方 法 用 于 指定 查询 结果 的 数量 ， 比 如 只 碍 表 中 的 前 3 条 数 
据 ， 就 可 以 这 样 写 : 
List<Book> books = Datasupport.1imit(3).find(Book.class); 


offset() 方 法 用 于 指定 查询 结果 的 偏 移 量 ， 比 如 查询 表 中 的 第 2 
条 、 第 3 条 、 第 4 条 数据 ， 就 可 以 这 样 写 : 


List<Book> books = DataSupport.1limit(3).offset(1).find(Book.class); 








由 于 1imit(3) 人 查询 到 的 是 前 3 条 数据 ， 这 里 我 们 再 加 上 offset(1) 进 行 一 
个 位 置 的 偏 移 ， 束 能 实现 查询 第 2 条 、 第 3 条 、 第 4 条 数据 的 功能 
了 。1limit() 和 offset() 方 法 共 tx 同 对 应 了 SQL 当中 的 limit 关 键 字 。 


当然 ， 你 还 可 以 对 这 5 个 方法 进行 任意 的 连 级 组 合 ， 来 完成 一 个 比较 复 
杂 的 查询 操作 : 











List<Book> books = DataSupport .Selec ct 人 (On ', "author", "pages") 
here 全 1 > ?3", "400") 
.order("pages") 
.limit(10) 
oie et(10) 
find(Book.class); 





这 段 代 码 就 表示 ， 查 询 Book 表 中 第 11~20 条 满足 页 数 大 于 400 这 个 条 件 





的 name、 author 和 pages 这 3 列 数据 ， 并 将 查询 结果 按照 页 数 升序 排列 。 


怎么 样 ? 是 不 是 感觉 LitePal 的 查询 功能 非常 强大 ， 并 且 代 码 明 显 更 加 简 
洁 ? 我 们 需要 用 到 一 个 方法 的 时 候 直 接连 级 一 下 就 可 以 了 ， 不 需要 的 话 
束 可 以 不 写 ， 而 不 是 像 之 前 的 query() 方 法 ， 不 管 需 不 需要 用 人 到， 部 必 

须要 传 固定 的 参数 进去 才 行 。 


关于 LitePal 的 查询 API 差 不 多 就 介绍 到 这 里 ， 这 些 API 已 经 足够 我 们 应 对 
绝 大 多 数 场景 的 查询 需求 了 。 当 前 ， 如 果 你 实在 有 一 些 特殊 需求 ， 上 述 
的 API 部 满足 不 了 你 的 时 候 ，LitePal 仍 然 支 持 使 用 原生 的 SQL 来 进行 查 


询 : 























Cursor c = DataSupport.findBySQL("select * from Book where pages > ? and price < ?", "400", "20"); 


调用 Datasupport.findBysQL() 方 法 来 进行 原生 查询 ， 其 中 第 一 个 参数 用 
于 指定 SQL 语 句 ， 后 面 的 参数 用 于 指定 占 位 符 的 值 。 注 意 findBysQL() 方 
法 返回 的 是 一 个 cursor 对 象 ， 接 下 来 你 还 需要 通过 之 前 所 学 的 老 方式 将 
数据 一 一 取出 才 行 。 


6.6 ”小 结 与 点 评 


经 过 了 这 一 章 漫 长 的 学 习 ， 我 们 终于 可 以 绥 解 一 下 疲 芝 ， 对 本 章 所 学 的 
知识 进行 梳理 和 总 结 了 。 本 章 主 要 是 对 Android 和 常用 的 数据 持久 化 方式 
进行 了 详细 的 讲解 ， 包 括 文件 存储 、SharedPreferences 存 储 以 及 数据 库 
存储 。 其 中 文件 适用 于 存储 一 些 简 单 的 文本 数据 或 者 二 进 制 数据 ， 
SharedPreferences 适 用 于 存储 一 些 键 值 对 ， 而 数据 库 则 适用 于 存储 那些 
复杂 的 关系 型 数据 。 虽 然 目前 你 已 经 掌握 了 这 3 种 数据 持久 化 方式 的 用 
法 ， 但 是 能 够 根据 项 目的 实际 需求 来 选择 最 合适 的 方式 也 是 你 未 来 需要 
继续 探索 的 。 


那么 正如 上 一 章 小 结 里 提 到 的 ， 既 然 现在 我 们 已 经 掌握 了 Android 中 的 
数据 持久 化 技术 ， 接 下 来 就 应 该 继续 学 习 Android 中 剩余 的 四 大 组 件 
了 。 放 松 一 下 自己 ， 然 后 一 起 踏 上 内 容 提 供 器 的 学 习 之 旅 吧 。 

















第 7 草 路 程序 共 理 数据 一 一 探 乞 内 
日 


在 上 一 章 中 我 们 学 了 Android 数 据 持久 化 的 技术 ， 包 括 文件 存储 、 
SharedPreferences 存 储 以 及 数据 库存 储 。 不 知道 你 有 没有 发 现 ， 使 用 这 
些 持久 化 技术 所 保存 的 数据 都 只 能 在 当前 应 用 程序 中 访问 。 虽 然 文 件 和 
SharedPreferences 存 储 中 提供 了 MODE _ WORLD _ READABLE 和 

MODE_ WORLD_WRITEABLE 这 两 种 操作 模式 ， 用 于 供给 其 他 的 应 用 
程序 访问 当前 应 用 的 数据 ， 但 这 两 种 模式 在 Android 4.2 版 本 中 都 已 被 废 
弃 了 。 为 什么 呢 ? 因为 Android 官 方 已 经 不 再 推荐 使 用 这 种 方式 来 实现 
人 而 是 应 该 使 用 更 加 安全 可 靠 的 内 容 提 供 器 技 








可 能 你 会 有 些 疑 惑 ， 为 什么 要 将 我 们 程序 中 的 数据 共有 至 给 其 他 程序 呢 ? 
当然 ， 这 个 是 要 视 情 况 而 定 的 ， 比 如 说 账号 和 密码 这 样 的 隐私 数据 显然 
是 不 能 共享 给 其 他 程序 的 ， 不 过 一 些 可 以 让 其 他 程序 进行 二 次 开发 的 基 
础 性 数据 ， 我 们 还 是 可 以 选择 将 其 共享 的 。 例 如 系统 的 电话 敌 程 序 ， 它 
的 数据 库 中 保存 了 很 多 的 联系 人 信息 ， 如 果 这 些 数据 都 不 允许 第 三 方 的 
程序 进行 访问 的 话 ， 芍 怕 很 多 应 用 的 功能 都 要 大 打折 扣 了 。 除 了 电话 竹 
之 外 ， 还 有 短信 、 媒 体 库 等 程序 都 实现 了 跨 程 序数 据 共 至 的 功能 ， 而 使 
用 的 技术 当然 束 是 内 容 提供 器 了 ， 下 面 我 们 束 来 对 这 一 拉 术 进行 深入 的 


探讨 。 














7.1 和 内容 提供 邢 人 简介 


内 容 提 供 器 〈Content Provider) 主要 用 于 在 不 同 的 应 用 程序 之 间 实 现 数 
据 共 享 的 功能 ， 它 提供 了 一 套 完整 的 机 制 ， 允 许 一 个 程序 访问 另 一 个 程 
序 中 的 数据 ， 同 时 还 能 保证 被 访 数据 的 安全 性 。 目 前 ， 使 用 内 容 提供 器 
是 Android 实 现 跨 程序 共享 数据 的 标准 方式 。 


不 同 于 文件 存储 和 SharedPreferences 存 储 中 的 两 种 全 局 可 读 写 操作 模 
式 ， 内 容 提供 器 可 以 选择 只 对 哪 一 部 分 数据 进行 共享 ， 从 而 保证 我 们 程 
序 中 的 隐私 数据 不 会 有 泄漏 的 风险 。 


不 过 在 正式 开始 学 习 内 容 提供 器 之 前 ， 我 们 需要 先 掌握 另外 一 个 非常 重 
要 的 知识 Android 运 行 时 权限 ， 因 为 待 会 的 内 容 提 供 器 示例 中 会 使 
用 到 运行 时 权限 的 功能 。 当 然 不 光 是 内 容 提供 器 ， 以 后 我 们 的 开发 过 程 
中 也 会 经 常 使 用 到 运行 时 权限 ， 因 此 你 必须 能 够 牢 牢 掌握 它 才 行 。 











7.2 ”运行 时 权限 


Android 的 权限 机 制 并 不 是 什么 新 鲜 事物 ， 从 系统 的 第 一 个 版 本 开始 就 
己 经 存在 了 。 但 其 实 之 前 Android 的 权限 机 制 在 保护 用 户 安 全 和 隐私 等 
方面 起 到 的 作用 比较 有 限 ， 尤 其 是 一 些 大 家 都 离 不 开 的 第 用 软件 ， 非 当 
容易 “ 店 大 坎 客 ”。 为 此 ，Android 开 发 团队 在 Android 6.0 系 统 中 引用 了 运 
行 时 权限 这 个 功能 ， 从 而 更 好 地 保护 了 用 户 的 安全 和 隐私 ， 那 么 本 节 我 
们 就 来 详细 学 习 一 下 这 个 6.0 系 统 中 引入 的 新 特性 。 


7.2.1 Android 权 限 机 制 详解 


首先 来 回顾 一 下 过 去 Android 的 权限 机 制 是 什么 样 的 。 我 们 在 第 5 章 写 
BroadcastTest 项 目的 时 候 第 一 次 接触 了 Android 权 限 相 关 的 内 容 ， 当 时 为 
了 要 访问 系统 的 网 络 状态 以 及 监听 开机 广播 ， 于 是 在 
AndroidManifest.xml 文 件 中 添加 了 这 样 两 句 权 限 声 明 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcasttest"> 








<uses -permission android:name="androi 
<uses -permission android:name="androi 


permission.ACCESS_NETWORK_STATE" /> 
.permission.RECEIVE_ BOOT_COMPLETED" /> 


</manifest> 


因为 访问 系统 的 网 络 状 态 以 及 监听 开机 广播 涉及 了 用 户 设备 的 安全 性 ， 
因此 必须 在 AndroidManifest.xzml 中 加 入 权限 声明 ， 人 否则 我 们 的 程序 束 会 


朋 演 。 


那么 现在 问题 来 了 ， 加 入 了 这 两 句 权 限 声明 后 ， 对 于 用 户 来 说 到 底 有 什 
么 影响 昵 ?为 什么 这 样 束 可 以 保护 用 户 设 备 的 安全 性 了 呢 ? 


其 实用 户主 要 在 以 下 两 个 方面 得 到 了 保护 ， 一 方面 ， 如 采用 户 在 低 于 
6.0 系 统 的 设备 上 安装 该 程序 ， 会 在 安装 界面 给 出 如 图 7.1 所 示 的 提醒 。 
这 样 用 户 束 可 以 清楚 地 知晓 该 程序 一 共 申 请 了 哪些 权限 ， 从 而 决定 是 否 
要 安装 这 个 程序 。 











二 BroadcastTest 
要 安装 此 应 用 吗 ? 它 将 获得 以 下 权限 : 


设备 相关 权限 


图 7.1 安装 界面 的 权限 提醒 


另 一 方面 ， 用 户 可 以 随时 在 应 用 程序 管理 界面 查看 任意 一 个 程序 的 权限 
申请 情况 ， 如 图 7.2 所 示 。 这 样 该 程序 申请 的 所 有 权限 就 尽 收 眼底 ， 什 
么 都 瞒 不 过 用 户 的 眼睛 ， 以 此 保证 应 用 程序 不 会 出 现 各 种 滥用 权限 的 情 
况 。 


A 画 23:18 


《6 ”应 用 信息 


缓存 


默认 操作 





0.00B 


图 7.2 管理 界面 的 权限 展示 


这 种 权限 机 制 的 设计 思路 其 实 非常 简单 ， 就 是 用 户 如 果 认 可 你 所 申请 的 
权限 ， 那 么 就 会 安装 你 的 程序 ， 如 果 不 认可 你 所 申请 的 权限 ， 那 么 拒 缀 
安装 就 可 以 了 。 

但 是 理想 是 美好 的 ， 现 实 却 很 残酷 ， 因 为 很 多 我 们 所 离 不 开 的 常用 软件 
普遍 存在 着 小 用 权限 的 情况 ， 不 管 到 底 用 不 用 得 到 ， 反 正 先 把 权限 申请 
了 再 说 。 比 如 说 微 信 所 申请 的 权限 列表 如 图 7.3 所 示 。 
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图 7.3 微 信 的 权限 列表 


这 只 是 微 信 所 申请 的 一 半 左 右 的 权限 ， 因 为 权限 太 多 一 屏 截 不 下 来 。 其 
中 有 一 些 权限 我 并 不 认可 ， 比 如 微 信 为 什么 要 读 取 我 手机 的 短信 和 彩 
信 ? 但 是 我 不 认可 又 能 怎样 ， 难 道 我 拒绝 安装 微 信 ? 没 错 ， 这 种 例子 比 
比 省 是 ， 当 一 些 软 件 已 经 让 我 们 产生 依赖 的 时 候 就 会 容易 “ 店 大 欺 客 ”， 
反正 这 个 权限 我 就是 要 了 ， 你 自己 看 着 办 吧 ! 


Android 开 发 团队 当然 也 意识 到 了 这 个 问题 ， 于 是 在 6.0 系 统 中 加 入 了 运 
行 时 权限 功能 。 也 就 是 说 ， 用 户 不 需要 在 安装 软件 的 时 候 一 次 性 授权 所 
有 申请 的 权限 ， 而 是 可 以 在 软件 的 使 用 过 程 中 再 对 某 一 项 权限 申请 进行 























授权 。 比 如 说 一 款 相 机 应 用 在 运行 时 申请 了 地 理 位 置 定 位 权限 ， 就 算 我 
拒绝 了 这 个 权限 ， 但 是 我 应 该 仍然 可 以 使 用 这 个 应 用 的 其 他 功能 ， 而 不 
是 像 之 前 那样 直接 无 法 安装 它 。 


当然 ， 并 不 是 所 有 权限 都 需要 在 运行 时 申请 ， 对 于 用 户 来 说 ， 不 停 地 授 
权 也 很 烦琐 。Android 现 在 将 所 有 的 权限 归 成 了 两 类 ， 一 类 是 普通 权 
限 ， 一 类 是 危险 权限 。 准 确 地 讲 ， 其 实 还 有 第 三 类 特殊 权限 ， 不 过 这 种 
权限 使 用 得 很 少 ， 因 此 不 在 本 书 的 讨论 范围 之 内 。 普 通 权 限 指 的 是 那些 
不 会 直接 威胁 到 用 户 的 安全 和 隐私 的 权限 ， 对 于 这 部 分 权限 申请 ， 系 统 
会 自动 帮 我 们 进行 授权 ， 而 不 需要 用 户 再 去 手动 操作 了 ， 比 如 在 
BroadcastTest 项 目 中 申请 的 两 个 权限 就 是 普通 权限 。 人 危险 权限 则 表示 那 
些 可 能 会 触及 用 户 隐 私 或 者 对 设备 安全 性 造成 影响 的 权限 ， 各 效 取 设备 
联系 人 信息 、 定 位 设备 的 地 理 位 置 等 ， 对 于 这 部 分 权限 申请 ， 必 须要 由 
用 户 手 动 点 击 授权 才 可 以 ， 人 否则 程序 束 无 法 使 用 相应 的 功能 

但 是 Android 中 有 一 共有 上 百 种 权限 ， 我 们 怎么 从 中 区 分 哪些 是 普通 权 
限 ， 哪 些 是 危险 权限 呢 ? 其 实 并 没有 那么 难 ， 因为 危险 权限 总 共 就 那么 


几 个 ， 除 了 危险 权限 之 外 ， 剩 余 的 惑 都 是 普通 权限 了 。 下 表 列 出 了 
Android 中 所 有 的 危险 权限 ， 共 是 9 组 24 个 权限 。 


权限 组 名 权限 名 
CALENDAR 本 _CALENDAR 
RITE_CALENDAR 

CAMERA CAMERA 


CONTACTS 入 CONTACTS 
_CONTACTS 
ET ob COUNTS 


_PHONE 
D_CALL_L 
R 
ADD _VOTCEMAIL 
USE_SIP 
PROCESS_OUTGOING_CALLS 


| 辆 SENSORS | 


















































这 张 表 格 你 看 起 来 可 能 并 不 会 那么 轻松 ， 因 为 里 面 的 权限 全 都 是 你 没 使 
用 过 的 。 不 过 没有 关系 ， 你 并 不 需要 了 解 表 格 中 每 个 权限 的 作用 ， 只 要 
把 它 当 成 一 个 参照 表 来 查看 就 行 了 。 每 当 要 使 用 一 个 权限 时 ， 可 以 先 到 
这 张 表 中 来 查 一 下 ， 如 果 是 属于 这 张 表 中 的 权限 ， 那 么 就 需要 进行 运行 
时 权限 处 理 ， 如 果 不 在 这 张 表 中 ， 那 么 只 需要 在 AndroidManifest.xml 文 
件 中 添加 一 下 权限 声明 就 可 以 了 。 


另外 注意 一 下 ， 表 格 中 每 个 危险 权限 都 属于 一 个 权限 组 ， 我 们 在 进行 运 
行 时 权限 处 理 时 使 用 的 是 权限 名 ， 但 是 用 户 一 旦 同意 授权 了 ， 那 么 该 权 
限 所 对 应 的 权限 组 中 所 有 的 其 他 权限 也 会 同时 被 授权 。 


访问 
http://developer.android.google.cn/reference/android/Manifest.permission.htmr 
可 以 查看 Android 系 统 中 完整 的 权限 列表 。 


好 了 ， 关 于 Android 权 限 机 制 的 内 容 就 讲 这 么 多 ， 理 论 知 识 你 已 经 了 解 
ee 。 接 下 来 我 们 就 学 习 一 下 到 底 如 何在 程序 运行 的 时 候 申 请 
久 限 。 


7.2.2 ”在 程序 运行 时 申请 权限 


首先 新 建 一 个 RuntimePermissionTest 项 目 ， 我 们 就 在 这 个 项 目的 基础 上 
来 学 习 运 行 时 权限 的 使 用 方法 。 在 开始 动手 之 前 还 需要 考虑 一 下 到 底 要 
申请 什么 权限 ， 其 实 刚 才 表 中 列 出 的 所 有 权限 都 是 可 以 申请 的 ， 这 里 简 
单 起 见 我 们 就 使 用 cALL_PHONE 这 个 权限 来 作为 本 小 节 中 的 示例 吧 。 


CALL_PHONE 这 个 权限 是 编写 拨打 电话 功能 的 时 候 需 要 声明 的 ， 因 为 拨打 
电话 会 涉及 用 户 手 机 的 资费 问题 ， 因 而 被 列 为 了 危险 权限 。 在 Android 
6.0 系 统 出 现 之 前 ， 拨 打 电 话 功能 的 实现 其 实 非常 简单 ， 修 改 
activity_main.xml 布 局 文件 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
































android:layout_height="match_parent"> 


<Button 
android:id="@+id/make_call" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Make Call" /> 


</LinearLayout> 





我 们 在 布局 文件 中 只 是 定义 了 一 个 按钮 ， 当 点 击 按钮 时 就 去 触发 拨打 电 
话 的 逻辑 。 接 着 修改 MainActivity 中 的 代码 ， 如 下 所 示 不 : 


public class MainActivity extends AppCompatActivity { 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity main); 
Button makeCall = (Button) findViewById(R.id.make_call); 
makeCall.setOonclickListener(new View.OnClickListener() { 
@override 
public void onClick(View v) { 
try 
Intent intent = new Intent(Intent. ACTION_CALL); 
intent. setData(Uri， parse("te1:10086" ) ) 
startActivity(intent); 
} catch (SecurityException e) { 
e.printStackTrace(); 
} 


} 
}); 


可 以 看 到 ， 在 按钮 的 点 击 事 件 中 ， 我 们 构建 了 一 个 隐 式 Intent ，Intent 的 
action 指 定 为 Intent .ACTION_cALL， 这 是 一 个 系统 内 置 的 打 电 话 的 动作 ， 
然后 在 data 部 分 指定 了 协议 是 tel， 号 码 是 10086。 其 实 这 部 分 代码 我 们 在 
2.3.3 小 节 中 就 已 经 见 过 了 ， 只 不 过 当时 指定 的 action 

是 Intent .ACTION_DIAL， 表 示 打 开 拨 号 界面 ， 这 个 是 不 需要 声明 权限 
的 ， 而 Intent ,ACTION_CALL 则 可 以 直接 拨打 电话 ， 因 此 必须 声明 权限 。 
男 外 为 了 防止 程序 骨 演 ， 我 们 将 所 有 操作 都 放 在 了 异常 捕获 代码 块 当 


O 








么 接 下 来 修改 AndroidManifest.xml 文 件 ， 在 其 中 声明 如 下 权限 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.runtimepermissiontest"> 


<uses-permission android:name="android.permission.CALL_PHONE" /> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


</application> 


</manifest> 


这 样 我 们 就 将 拨打 电话 的 功能 成 功 实 现 了 ， 并 有 旦 在 低 于 Android 6.0 系 统 
的 手机 上 都 是 可 以 正常 运行 的 ， 但 是 如 果 我 们 在 6.0 或 者 更 高 版 本 系统 
的 手机 上 运行 ， 点 击 Make Call 按钮 就 没有 任何 效果 ， 这 时 观察 logcat 中 
的 打印 日 志 ， 你 会 看 到 如 图 7.4 所 示 的 错误 信息 。 


java. lang. SecurityException: Permission Denial: starting Intent { act=android. intent.action.CALL 





at android. os. Parcel. readException ( 
at android. os. Parcel. readException ( ) 


at android. app. ActivityManagerProxy. startActivity (ActivityManagerNative, java:2658) 


at android. app. Instrumentation. execStartActivity ( ) 

at android. app, Activity. startActivityForResult ( ) 

at android. app. Activity. startActivityForResult ( ) 

at android. support. v4. app. FragmentActivity. startActivityForResult ( ) 
at android. app. Activity. startActivity!( ) 

at android. app. Activity. startActivVity( 让 





at com. example. runtimepermissiontest. MainActivityS$Sl. onClick (4 


图 7.4 错误 日 志 信 息 


昔 误 信 息 中 提醒 我 们 “Permission ”Denial*， 可 以 看 出 ， 是 由 于 权限 被 禁 
0 因为 6.0 及 以 上 系统 在 使 用 危险 权限 时 都 必须 进行 运行 时 
流 限 处 理 。 


那么 下 面 我 们 就 来 尝试 修复 这 个 问题 ， 修 改 MainActivity 中 的 代码 ， 如 
下 所 示 : 


public class MainActivity extends AppCompatActivity { 








@Override 
protected void onCreate(Bundle SavedInstanceState) { 
super .onCreate(savedInstanceSstate); 
setContentView(R.1layout.activity main); 
Button makeCall = (Button) findViewById(R.id.make_call); 
makeCall.setOonCclickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest. 
permission.CALL_PHONE) != PackageManager .PERMISSION GRANTED) { 
ActivityCompat.requestPermissions(MainActivity.this, new 
String[]{ Manifest.permission.CALL_PHONE }, 1); 


} else { 
Sall() 
J 
}); 
站 
private void call() { 
try { 


Intent intent = new Intent(Intent.ACTION_CALL) 
intent.setData(Uri.parse("tel:10086")); 
startActivity(intent); 

} catch (SecurityException e) { 
e.printstackTrace(); 

中 


Q@override 
public void onRequestPermissionsResult(int requestCode, String[] permissions, 


int[] grantResults) { 
switch (requestCode) { 
case 1 D 
(grantResults.length > 9 && grantResults[0] == PackageManager. 
PERMISSION_GRANTED) { 
} else { 
Toast k (this, 


ast.makeText(t "You denied the permission", Toast.LENGTH_ 
SHORT) .show(); 








上 面 的 代码 将 运行 时 权限 的 完整 流程 都 覆盖 了 ， 下 面 我 们 来 具体 解析 一 
下 。 说 白 了 ， 运 行 时 权限 的 核心 就 是 在 程序 运行 过 程 中 由 用 户 授 权 我 们 
去 执行 菏 些 危 险 操 作 ， 程 序 是 不 可 以 擅自 做 主 去 执行 这 些 危 险 操 作 的 。 
因此 ， 第 一 步 就 是 要 先 判 断 用 户 是 不 是 已 经 给 过 我 们 授权 了 ， 借 助 的 
是 contextCcompat .checkSelLlfPermission() 方 法 。 checkSelfPermission() 
方法 接收 两 个 参数 ， 第 一 个 参数 是 context， 这 个 没什么 好 说 的 ， 第 二 
个 参数 是 具体 的 权限 名 ， 比 如 打 电 话 的 权限 名 就 

是 Manifest.permission,CALL_PHONE， 然后 我 们 使 用 方法 的 返回 值 和 
PackageManager .PERMISSION_GRANTED 做 比较 ， 相 等 就 说 明 用 户 已 经 授 
权 ， 不 等 就 表示 用 户 没有 授权 。 


如 果 已 经 授权 的 话 就 简单 了 ， 直 接 去 执行 拨打 电话 的 逻辑 操作 就 可 以 
了 ， 这 里 我 们 把 拨打 电话 的 逻辑 封装 到 了 cal1() 方 法 当中 。 如 果 没 有 授 
权 的 话 ， 则 需要 调用 Activitycompat .requestPermissions( ) 方 法 来 问 用 
户 申请 授权 ，requestPermissions() 方 法 接收 3 个 参数 ， 第 一 个 参数 要 求 
是 Activity 的 实例 ， 第 二 个 参数 是 一 个 string 数 组 ， 我 们 把 要 申请 的 权限 
人 
里 1 


调用 完了 requestPermissions() 方 法 之 后 ， 系 统 会 弹出 一 个 权限 申请 的 
对 话 框 ， 然 后 用 户 可 以 选择 同意 或 拒绝 我 们 的 权限 申请 ， 不 论 是 哪 种 结 
果 ， 最 终 都 会 回调 到 onRequestPermissionsResult() 方 法 中 ， 而 授权 的 
结果 则 会 封装 在 grantResults 参 数 当 中 。 这 里 我 们 只 需要 判断 一 下 最 后 
的 授权 结果 ， 如 果 用 户 同 意 的 话 束 调用 cal1() 方 法 来 拨打 电话 ， 如 果 用 
户 拒 绝 的 话 我 们 只 能 放弃 操作 ， 并 且 弹 出 一 条 失败 提示 。 


现在 重新 运行 一 下 程序 ， 并 点 击 Make Call 按 钮 ， 效 果 如 图 7.5 所 示 。 





























Allow RuntimePermis 
sionTest to make and 
manage phone calls? 


DENY ALLOW 





图 7.5 申请 电话 权限 对 话 框 


由 于 用 户 还 没有 授权 过 我 们 拨打 电话 权限 ， 因 此 第 一 次 运行 会 弹出 这 样 
一 个 权限 申请 的 对 话 框 ， 用 户 可 以 选择 同意 或 者 拒绝 ， 比 如 说 这 里 点 击 
了 DENY， 结 果 如 图 7.6 所 示 。 








RuntimePermissionTest 





MAKE CALL 






You denied the permission 





图 7.6 用户 拒绝 了 权限 申请 

由 于 用 户 没有 同意 授权 ， 我 们 只 能 弹出 一 个 操作 失败 的 提示 。 下 面 我 们 
再 次 点 击 Make Call 按 钮 ， 仍 然 会 弹出 权限 申请 的 对 话 框 ， 这 次 点 击 
ALLOW， 结 果 如 图 7.7 所 示 。 





图 7.7 拨打 电话 界面 


可 以 看 到 ， 这 次 我 们 就 成 功 进入 到 拨打 电话 界面 了 ， 并 且 由 于 用 户 已 经 
完成 了 授权 操作 ， 之 后 再 点 击 Make Call 按 钮 就 不 会 再 弹出 权限 申请 对 话 
框 了 ， 而 是 可 以 直接 拨打 电话 。 那 可 能 你 会 担心 ， 万 一 以 后 我 又 后 悔 了 
怎么 办 ? 没有 关系 ， 用 户 随 时 都 可 以 将 授予 程序 的 危险 权限 进行 关闭 ， 

进入 Settings ~ Apps -，RuntimePermissionTest ~- Permissions， 界 面 如 


图 7.8 所 示 。 








€ App permissions 


人 RuntimePermissionTest 








图 7.8 应 用 程序 权限 管理 界面 
在 这 里 我 们 就 可 以 对 任何 授予 过 的 危险 权限 进行 关闭 了 。 
好 了 ， 关 于 运行 时 权限 的 内 容 就 讲 到 这 里 ， 现 在 你 已 经 有 能 力 处 理 


Android 上 各 种 关于 权限 的 问题 了 ， 下 面 我 们 就 来 进入 本 章 的 正题 一 一 
内 容 提供 器 。 











7.3 访问 其 他 程序 中 的 数据 


内 容 提供 器 的 用 法 一 般 有 两 种 ， 一 种 是 使 用 现 有 的 内 容 提供 器 来 读 取 和 
操作 相应 程序 中 的 数据 ， 另 一 种 是 创建 自己 的 内 容 提供 器 给 我 们 程序 的 
数据 提供 外 部 访问 接口 。 那 么 接 下 来 我 们 就 一 个 一 个 开始 学 习 吧 ， 弟 先 
从 使 用 现 有 的 内 容 提 供 占 开始 。 


如 果 一 个 应 用 程序 通过 内 容 提供 器 对 其 数据 提供 了 外 部 访问 接口 ， 那 么 
任何 其 他 的 应 用 程序 残 都 可 以 对 这 部 分 数据 进行 访问 。Android 系 统 中 
目 融 的 电话 每 、 短 信 、 妊 体 库 等 程序 都 提供 了 类 似 的 访问 接口 ， 这 就 使 
得 第 三 方 应 用 程序 可 以 充分 地 利用 这 部 分 数据 来 实现 更 好 的 功能 。 下 面 
我 们 就 来 看 一 看 ， 内 容 提供 器 到 后 是 如 何 使 用 的 。 


7.3.1 ”ContentResolver 的 基本 用 法 


对 于 每 一 个 应 用 程序 来 说 ， 如 果 想 要 访问 内 容 提 供 右 中 共享 的 数据 ， 就 
一 定 要 借助 ContentResolver 类 ， 可 以 通过 Context 中 的 
getCcontentResolver() 方 法 获取 到 该 类 的 实例 。ContentResolver 中 提供 
了 一 系列 的 方法 用 于 对 数据 进行 CRUD 操 作 ， 其 中 insert() 方 法 用 于 添 
加 数据 ，update() 方 法 用 于 更 新 数据 ，delete() 方 法 用 于 删除 数 

据 ，query() 方 法 用 于 查询 数据 。 有 没有 似曾相识 的 感觉 ? 没 错 ， 
SQLiteDatabase 中 也 是 使 用 这 几 个 方法 来 进行 CRUD 操 作 的 ， 只 不 过 它 
们 在 方法 参数 上 稍微 有 一 些 区 别 。 


不 同 于 SQLiteDatabase，ContentResolver 中 的 增删 改 碍 方法 都 是 不 接收 
表 名 参数 的 ， 而 是 使 用 一 个 uri 参 数 代 奉 ， 这 个 参数 被 称 为 内 容 URI。 内 
容 URI 给 内 容 提 供 嚣 中 的 数据 建立 了 唯一 标识 符 ， 它 主要 由 两 部 分 组 
成 : authority 和 path。authority 是 用 于 对 不 同 的 应 用 程序 做 区 分 的 ， 一 般 
为 了 避免 冲突 ， 都 会 采用 程序 包 名 的 方式 来 进行 命名 。 比 如 某 个 程序 的 
包 名 是 com.example.app， 那 么 该 程序 对 应 的 authority 束 可 以 命名 为 
com.example.app.provider。path 则 是 用 于 对 同一 应 用 程序 中 不 同 的 表 做 
区 分 的 ， 通 常 都 会 添加 到 authority 的 后 面 。 比 如 某 个 程序 的 数据 库 里 存 
在 两 张 表 : table1 和 table2， 这 时 就 可 以 将 path 分 别 命名 为 /tablel 

和 /table2， 然 后 把 authority 和 path 进 行 组 合 ， 内 容 URI 就 变 成 了 
com.example.app.provider/tablel1 和 com.example.app.provider/table2。 不 























过 ， 目 前 还 很 难 养 认 出 这 两 个 字符 串 束 是 两 个 内 容 URI， 我 们 还 需要 在 
字符 串 的 头 部 加 上 协议 声明 。 因 此 ， 内 容 URI 最 标准 的 格式 写法 如 下 : 


content://com.example.app.provider/table1 
content://com.example.app.provider/table2 


有 没有 发 现 ， 内 容 URI 可 以 非常 清楚 地 表达 出 我 们 想 要 访问 哪个 程序 中 
哪 张 表 里 的 数据 。 也 正 是 因此 ，ContentResolver 中 的 增删 改 查 方法 才 都 
接收 uri 对 象 作为 参数 ， 因 为 如 果 使 用 表 名 的 话 ， 系 统 将 无 法 得 知 我 们 
期 望 访问 的 是 哪个 应 用 程序 里 的 表 。 


在 得 到 了 内 容 URI 字 符 串 之 后 ， 我 们 还 需要 将 它 解析 成 Uri 对象 才 可 以 作 
为 参数 传 入 。 解 析 的 方法 也 相当 简单 ， 代 码 如 下 所 示 : 


Uri uri = Uri.parse("content://com.example.app.provider/table1") 
只 需要 调用 uri.parse() 方 法 ， 束 可 以 将 内 容 URI 字 符 串 解析 成 uri 对 象 
人 


ee 这 个 Uri 对 象 来 查询 tablel 表 中 的 数据 了 ， 代 码 如 下 
不 : 


Cursor cursor = getContentResolver().query( 


这 些 参数 和 SQLiteDatabase 中 query() 方 法 里 的 参数 很 像 ， 但 总 体 来 说 要 
简单 一 些 ， 毕 竟 这 是 在 访问 其 ， 没 必 要 构建 过 于 复杂 的 
查询 语句 。 下 表 对 使 用 到 的 这 部 分 参数 进行 了 详细 的 解释 。 














车 述 
| e column = value 指定 where 的 约束 条 件 
"= 















| 本 | - | 为 where 中 的 占 位 符 提供 具体 的 值 








order by column1，column2 册 指定 查询 结果 的 排序 方式 





查询 完成 后 返回 的 仍然 是 一 个 cursor 对 象 ， 这 时 我 们 就 可 以 将 数据 从 

cursor 对 象 中 逐个 读 取 出 来 了 。 读 取 的 思路 仍然 是 通过 移动 游标 的 位 置 

a 然后 再 取出 每 一 行 中 相应 列 的 数据 ， 代 码 如 下 
小: 


if (cursor != null) { 
while (cursor.moveToNext()) { 
String column1 = cursor.getString(cursor.getCcolumnIndex("column1")); 
int column2 = cursor.getInt(cursor.getCcolumnIindex("column2")); 


} 
cursor.close(); 


掌握 了 最 难 的 查询 操作 ， 剩 下 的 增加 、 修 改 、 删 除 操 作 就 更 不 在 话 下 
了 。 我 们 先 来 看 看 如 何 同 table1 表 中 添加 一 条 数据 ， 代 码 如 下 所 不: 


ContentValues values = new ContentValues(); 
values.put("columni", "text"); 
values.put("column2", 1 
getContentResolver().insert(uri, values); 


可 以 看 到 ， 仍 然 是 将 答 添 加 的 数据 组 装 到 ContentValues 中 ， 然 后 调用 
ContentResolver 的 insert() 方 法 ， 将 Uri 和 ContentValues 作 为 参数 传 入 即 
回民 


现在 如 果 我 们 想 要 更 新 这 条 新 添加 的 数据 ， 把 column1 的 值 清空 ， 可 以 
借助 ContentResolver 的 update() 方 法 实现 ， 代 码 如 下 所 示 : 


ContentValues values = new ContentValues(); 

values.put("column1i", ""); 

getContentResolver().update(uri, values, "columni1 = ? and column2 = ?", new 
Strinegll] Ttewt™. Tay 


注意 上 述 代码 使 用 了 selection 和 selectionArgs 参 数 来 对 想 要 更 新 的 数 
据 进 行 约束 ， 以 防止 所 有 的 行 都 会 受 影响 。 


最 后 ， 可 以 调用 ContentResolver 的 delete() 方 法 将 这 条 数据 删除 掉 ， 代 
人 码 如 下 所 示 : 


getContentResolver().delete(uri, "column2 = ?", new String[] { "1" }); 





到 这 里 为 止 ， 我们 就 把 ContentResolver 中 的 增删 改 查 方法 全 部 学 完 

是 不 是 感觉 一 看 就 履 ? 因为 这 些 知识 早 在 上 一 章 中 学 习 SQLiteDatabase 
的 时 候 你 就 已 经 掌握 7 了， 所 需 特 别 注意 的 束 只 有 uri 这 个 参数 而 已 。 那 
ee 目前 所 学 的 知识 ， 看 一 看 如 何 读 取 系统 电话 短 中 


7.3.2” 读 取 系 统 联 系 人 
由 于 我 们 之 前 一 直 使 用 的 都 是 模拟 器 ， 电 话 短 里 面 并 没有 联系 人 存在 ， 


所 以 现在 需要 上 自己 手动 添加 几 个 ， 以 便 稍 后 进行 读 取 。 打 开 电 话 短 程 
序 ， 界 面 如 图 7.9 所 示 。 








ADDACONTACT 








图 7.9 电话 注 程 序 主 界面 





可 以 看 到 ， 目 前 电话 短 里 是 没有 任何 联系 人 的 ， 我 们 可 以 通过 点 击 ADD 
A CONTACT 按 钮 来 对 联系 人 进行 创建 。 这 里 就 先 创建 两 个 联系 人 吧 ， 
分 别 填 入 他 们 的 姓名 和 手机 和 号， 如 图 7.10 所 示 。 


Add new contact v : Add new contact 


Tom John 








1 234-567-890| (098) 765-4321 


More Fields More Fieids 





图 7.10 添加 两 个 联系 人 
Tt 
动 和 于 吧 。 





首先 还 是 来 编写 一 下 布局 文件 ， 这 里 我 们 希望 读 取出 来 的 联系 人 信息 能 
够 在 ListView 中 显示 ， 因 此 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 
人 外: 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
ndroid:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<ListView 
android:id="@+id/contacts_view" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 
</ListView> 


</LinearLayout> 


简单 起 见 ，LinearLayout 里 就 只 放置 了 一 个 ListView。 这 里 使 用 ListView 
而 不 是 RecyclerView， 是 因为 我 们 要 将 关注 的 重点 放 在 读 取 系统 联系 人 
上 和 面 ， 如 果 使 用 RecyclerView 的 话 ， 代 码 偏 多 ， 会 容易 让 我 们 找 不 着 重 


Wyo 


接着 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 





ArrayAdapter<String> adapter; 
List<String> contactsList = new ArrayList<>(); 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super .oncCreate(SavedInstanceState) 
setContentView(R.1layout.activity main); 
ListView contactsView = (ListView) findViewById(R.id.contacts_ view); 
adapter = new ArrayAdapter<String>(this, android.R.layout. simple_list_ 
item 1, contactsList); 
contactsView.setAdapter (adapter); 
if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_ 
CONTACTS) != PackageManager .PERMISSION GRANTED) { 
ActivityCompat.requestPermissions(this, new String[]{ Manifest. 
permission.READ_CONTACTS }, 1); 
} else { 
readContacts(); 
} 


} 


private void readContacts() { 
Cursor cursor = null; 
try { 
// 查询 联系 人 数据 
cursor = getContentResolver().query(ContactsContract.CommonDataKinds. 
Phone .CONTENT_URI, null, null, null, null); 
if (cursor != null) { 
while (cursor.moveToNext()) { 
// 获取 联系 人 姓名 
String displayName = cursor.getString(cursor .getCoLlumnIndex 
(ContactsCcontract .CommonDataKkinds .Phone.DISPLAY_NAME) ) ， 
// 获取 联系 人 手机 号 
String number = cursor.getString(cursor .getColumnIndex 
(ContactsCcontract .CommonDataKkinds .Phone .NUMBER) ) ， 
contactsList.add(displayName + "\n" + Number); 





adapter .notifyDataSetChanged() ; 


} 
} catch (Exception e) { 
e.printSstackTrace(); 


} finally { 
if (cursor != null) { 
cursor.close(); 
} 
} 
} 
@Ooverride 


public void onRequestPermissionsResult(int requestCode, String[] permissions, 
int[] grantResults) { 
Switch (requestCode) { 
case 1: 
if (grantResults.length > 0 && grantResults[0] == PackageManager. 
PERMISSION_GRANTED) { 
readContacts(); 
} else { 
Toast.makeText(this, "You denied the permission"，Toast .LENGTH_ 
SHORT). show(); 
} 
break; 
default: 


在 oncreate() 方 法 中 ， 我 们 首先 获取 了 ListView 控 件 的 实例 ， 并 给 它 设 
置 好 了 适 配 右 ， 然 后 开始 调用 运行 时 权限 的 处 理 逻 辑 ， 因 为 
READ_CONTACTS 权 限 是 属于 危险 权限 的 。 关 于 运行 时 权限 的 处 理 流 
程 相 信 你 已 经 熟练 掌握 了 ， 这 里 我 们 在 用 户 授 权 之 后 调 

用 readcontacts() 方 法 来 读 取 系统 联系 人 信息 。 


下 面 重 点 看 一 下 readcontacts() 方 法 ， 可 以 看 到 ， 这 里 使 用 了 
ContentResolver 的 query() 方 法 来 查询 系统 的 联系 人 数据 。 不 过 传 入 的 
uri 参数 怎 么 有 些 奇怪 啊 ? 为 什么 没有 调用 Uri.parse() 方 法 去 解析 一 个 
内 容 URI 字 符 串 呢 ? 这 是 因为 contactscontract .CommonDataKinds .Phone 
类 已 经 帮 我 们 做 好 了 封装 ， 提 供 了 一 个 cONTENT_URI 常 量 ， 而 这 个 常量 
束 是 使 用 uri.,parse() 方 法 解析 出 来 的 结果 。 接 着 我 们 对 cursor 对 象 进 行 
通 历 ， 将 联系 人 姓名 和 手机 号 这 些 数据 逐个 取出 ， 联 系 人 姓名 这 一 列 对 
应 的 常量 是 contactscontract .CommonDataKinds .Phone.DISPLAY_NAME， 
联系 人 手机 号 这 一 列 对 应 的 常量 

是 contactsContract.CommonDataKinds .Phone .NUMBER。 两 个 数据 都 取出 
之 后 ， 将 它们 进行 拼接 ， 并 且 在 中 间 加 上 换行 符 ， 然 后 将 拼接 后 的 数据 
添加 到 ListView 的 数据 源 里 ， 并 通知 刷新 一 下 ListView。 最 后 千 万 不 要 
访 记 将 cursor 对 象 天 闭 挥 。 


这 样 就 结束 了 吗 ? 还 差 一 点 点 ， 读 取 系 统 联系 人 的 权限 千 万 不 能 瑟 记 声 
明 。 修 改 AndroidManifest.xml 中 的 代码 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.contactstest"> 








<uses -permission android:name="android.permission.READ_CONTACTS" /> 


</manifest> 


加 入 了 android.permission.READ_CONTACTS 权 限 ， 这 样 我 们 的 程序 就 可 
以 访问 到 系统 的 联系 人 数据 了 。 现 在 才 算是 大 功 告 成 了 ， 让 我 们 来 运行 
一 下 程序 吧 ， 效 果 如 图 7.11 所 示 。 


EE Allow ContactsTest to 


—— aCccessyour contacts? 


DENY ALLOW 





图 7.11 申请 访问 联系 人 权限 对 话 框 


首先 弹出 了 申请 访问 联系 人 权限 的 对 话 框 ， 我 们 点 击 ALLOW， 然 后 结 
果 如 图 7.12 所 示 。 


ContactsTest 


John 
(098) 765-4321 


Tom 
] 234-567-890 








图 7.12 展示 系统 联系 人 信息 


刚刚 添加 的 两 个 联系 人 的 数据 都 成 功 读 取出 来 了 ! 这 说 明 跨 程序 访问 数 
据 的 功能 确实 是 实现 了 。 


7.4 ”创建 目 己 的 内 容 提 供 占 


在 上 一 节 当 中 ， 我们 学 习 了 如 何在 自己 的 程序 中 访问 其 他 应 用 程序 的 数 
据 。 总 体 来 说 思路 还 是 非常 简单 的 ， 只 需要 获取 到 该 应 用 程序 的 内 容 
URI， 然 后 借助 ContentResolver 进 行 CRUD 操 作 束 可 以 了 。 可 是 你 有 没 
有 想 过 ， 那 些 提供 外 部 访问 接口 的 应 用 程序 都 是 如 何 实现 这 种 功能 的 
呢 ? 它们 又 是 怎样 保证 数据 的 安全 性 ， 使 得 隐私 数据 不 会 泄漏 出 去 ?学 
习 完 本 节 的 知识 后 ， 你 的 疑惑 将 会 被 一 一 解 开 。 


7.4.1 创建 内 容 提 供 絮 的 步 又 


前 面 己 经 提 到 过 ， 如 果 想 要 实现 路 程序 共享 数据 的 功能 ， 官 方 推荐 的 方 
式 就 是 使 用 内 容 提供 器 ， 可 以 通过 新 建 一 个 类 去 继承 contentProvider 的 
方式 来 创建 一 个 自己 的 内 容 提 供 器 。contentProvider 类 中 有 6 个 抽象 方 
法 ， 我 们 在 使 用 子 类 继承 它 的 时 候 ， 需 要 将 这 6 个 方法 全 部 重 写 。 新 建 
MyProvider 继 承 自 contentProvider， 代 码 如 下 所 示 : 








public class MyProvider extends ContentProvider { 


@override 
public boolean onCreate() { 
return false; 


} 


@Ooverride 

public Cursor query(Uri uri, String[] projection, String selection, String[] 
selectionArgs, String sortOrder) { 
return null; 


} 


@override 
public Uri insert(Uri uri, ContentValues values) { 
return null; 


} 


@override 

public int update(Uri uri, ContentValues values, String selection, String[] 
selectionArgs) { 
return 0; 


} 


@override 
public int delete(Uri uri, String selection, String[] selectionArgs) { 
return 0; 


} 


@override 
public String getType(Uri uri) { 
return null; 


} 





在 这 6 个 方法 中 ， 相 信 大 多 数 你 都 已 经 非常 熟 秋 了， 我 再 来 简单 介绍 一 
下 吧 。 


1. oncreate() 


初始 化 内 容 提供 更 的 时 候 调 用 。 通 常会 在 这 里 完成 对 数据 库 的 创建 
和 升级 等 操作 ， 返 回 true 表 示 内 容 提供 器 初始 化 成 功 ， 返 回 false 
则 表示 失败 。 








2. query() 


从 内 容 提 供 器 中 查询 数据 。 使 用 uri 参 数 来 确定 查询 哪 张 

表 ，projection 参 数 用 于 确定 查询 哪些 列 ，selection 和 
selectionArgs 参 数 用 于 约束 查询 哪些 行 ，sortorder 参 数 用 于 对 结 
果 进 行 排序 ， 查 询 的 结果 存放 在 cursor 对 象 中 返回 。 





3. insert() 


向 内 容 提 供 器 中 添加 一 条 数据 。 使 用 uri 参 数 来 确定 要 添加 到 的 
表 ， 待 添加 的 数据 保存 在 values 参 数 中 。 添 加 完成 后 ， 返 回 一 个 用 
于 表示 这 条 新 记录 的 URI。 





4. update() 


更 新 内 容 提供 器 中 已 有 的 数据 。 使 用 uri 参 数 来 确定 更 新 哪 一 张 表 
中 的 数据 ， 新 数据 保存 在 values 参 数 中 ，selection 和 
人 于 约束 更 新 哪些 行 ， 受 影响 的 行 数 将 作为 返 
回 值 返回 。 


5. delete() 
从 内 容 提供 器 中 删除 数据 。 使 用 uri 参 数 来 确定 删除 哪 一 张 表 中 的 
数据 ，selection 和 selectionArgs 参 数 用 于 约束 删除 哪些 行 ， 被 删 
除 的 行 数 将 作为 返回 值 返回 。 

6. getType() 


根据 传 入 的 内 容 URI 来 返回 相应 的 MIME 类 型 。 
可 以 看 到 ， 几 乎 每 一 个 方法 都 会 带 有 uri 这 个 参数 ， 这 个 参数 也 正 是 调 


用 ContentResolver 的 增删 改 查 方法 时 传递 过 来 的 。 而 现在 ， 我 们 需要 对 
传 入 的 uri 参 数 进行 解析 ， 从 中 分 析出 调用 方 期 望 访问 的 表 和 数据 。 
回顾 一 下 ， 一 个 标准 的 内 容 URI 写 法 是 这 样 的 : 


content://com.example.app.provider/tablel1 


这 就 表示 调用 方 期 望 访问 的 是 com.example.app 这 个 应 用 的 tablel 表 中 的 
2 。 除 此 之 外 ， 我 们 还 可 以 在 这 个 内 容 URI 的 后 面 加 上 一 个 id， 如 下 
人 小 : 


content://com.example.app.provider/table1/1 


这 就 表示 调用 方 期 望 访问 的 是 com.example.app 这 个 应 用 的 tablel 表 中 id 
为 1 的 数据 。 


内 容 URI 的 格式 主要 束 只 有 以 上 两 种 ， 以 路 径 结尾 就 表示 期 望 访问 该 表 
中 所 有 的 数据 ， 以 id 结尾 就 表示 期 望 访问 该 表 中 拥有 相应 id 的 数据 。 我 
们 可 以 使 用 通配符 的 方式 来 分 别 匹 配 这 两 种 格式 的 内 容 URI， 规 则 如 
Fs 





。*; 表示 匹配 任意 长 度 的 任意 字符 。 
。#: 表示 匹配 任意 长 度 的 数字 。 
所 以 ， 一 个 能 够 匹配 任意 表 的 内 容 URI 格 式 束 可 以 写成 : 


content://com.example.app.provider/* 





而 一 个 能 够 匹配 table1l 表 中 任意 一 行 数据 的 内 容 URI 格 式 就 可 以 与 成 : 


content://com.example.app.provider/table1/# 


接着 ， 我 们 再 借助 UriMatcher 这 个 类 惑 可 以 轻松 地 实现 匹配 内 容 URI 的 
功能 。UriMatcher 中 提供 了 一 个 adduRI() 方 法 ， 这 个 方法 接收 3 个 参数 ， 


可 以 分 别 把 authority、path 和 一 个 自 定义 代码 传 进去 。 这 样 ， 当 调用 
UriMatcher 的 match() 方 法 时 ， 就 可 以 将 一 个 uri 对 象 传 入 ， 返 回 值 是 某 
个 能 够 匹配 这 个 Uri 对 象 所 对 应 的 自 定 义 代 码 ， 利 用 这 个 代码 ， 我 们 就 
可 以 判断 出 调用 方 期 望 访问 的 是 哪 张 表 中 的 数据 了 。 修 改 MyProvider 中 
的 代码 ， 如 下 所 示 : 


public class MyProvider extends ContentProvider { 
public static final int TABLE1 DIR = 0; 
public static final int TABLE1_ITEM = 1; 
public static final int TABLE2_DIR = 2; 
public static final int TABLE2_ITEM = 3; 
private static UriMatcher uriMatcher; 
static { 


uriMatcher = new UriMatcher (UriMatcher NOMATCH); 
uriMatcher .addURI("com.example.app.provider", "table1", TABLE1_DIR); 


| 7 
uriMatcher .addURI("com.example.app.provider ", "table1/#", TABLE1_ITEM) 
uriMatcher .addURI("com.example.app.provider ", "table2", TABLE2_DIR); 
uriMatcher .addURI("com.example.app.provider ", "table2/#", TABLE2_ITEM); 

} 

@Ooverride 


public Cursor query(Uri uri, String[] projection, String selection, String[] 
selectionArgs, String sortOrder) { 
Switch (uriMatcher.match(uri)) { 
case TABLE1_DIR : 
// 查询 table1 表 中 的 所 有 数据 
k: 


case TABLE1 ITEM: 
// 查询 table1 表 中 的 单条 数据 


case TABLE2_DIR: 
// 查询 table2 表 中 的 所 有 数据 


case TABLE2_ITEM: 
Xr 查询 table2 表 中 的 单条 数据 





可 以 看 到 ，MyProvider 中 新 增 了 4 个 整 型 常量 ， 其 中 TABLE1_DIR 表 示 访 问 
tablel 表 中 的 所 有 数据 ，TABLE1_ITEM 表 示 访 问 tablel 表 中 的 单条 数 

据 ，TABLE2_DIR 表 示 访 问 table2 表 中 的 所 有 数据 ，TABLE2_ITEM 表 示 访 问 
table2 表 中 的 单条 数据 。 接 着 在 静态 代码 块 里 我 们 创建 了 UriMatcher 的 实 
例 ， 并 调用 adduRI() 方 法 ， 将 期 望 匹配 的 内 容 URI 格 式 传 递 进去 ， 注 意 
这 里 传 入 的 路 径 参 数 是 可 以 使 用 通配符 的 。 然 后 当 query( ) 方 法 被 调用 
的 时 候 ， 就 会 通过 UriMatcher 的 match() 方 法 对 传 入 的 uri 对 象 进行 匹 
配 ， 如 果 发 现 UriMatcher 中 某 个 内 容 URI 格 式 成 功 匹 配 了 该 uri 对 象 ， 则 
会 返回 相应 的 自 定 义 代码 ， 然 后 我 们 就 可 以 判断 出 调用 方 期 望 访问 的 到 
底 是 什么 数据 了 。 


上 述 代 码 只 是 以 query() 方 法 为 例 做 了 个 示范 ， 其 实 
insert()、update()、delete() 这 几 个 方法 的 实现 也 是 差不多 的 ， 它 们 
都 会 携带 uri 这 个 参数 ， 然 后 同样 利用 UriMatcher 的 match( ) 方 法 判断 出 
调用 方 期 望 访问 的 是 哪 张 表 ， 再 对 该 表 中 的 数据 进行 相应 的 操作 就 可 以 
村 





除 此 之 外 ， 还 有 一 个 方法 你 会 比较 陌生 ， 即 getType() 方 法 。 它 是 所 有 
的 内 容 提供 器 都 必须 提供 的 一 个 方法 ， 用 于 获取 uri 对 象 所 对 应 的 MIME 
类 型 。 一 个 内 容 URI 所 对 应 的 MIME 字 符 串 主要 由 3 部 分 组 成 ，Android 
对 这 3 个 部 分 做 了 如 下 格式 规定 。 


© 必须 以 vnd 开 头 5 


。 如 果 内 容 URI 以 路 径 络 尾 ， 则 后 接 android.cursor.dir/， 如 果 内 容 
URI 愉 id 结尾 ， 则 后 接 android,cursor .item/。 


。 最 后 接 上 vnd.<authority>.<path>。 


所 以 ， 对 于 content://com.example.app.provider/tablel 这 个 内 容 URI， 它 所 
对 应 的 MIME 类 型 就 可 以 写成 : 


vnd.android.cursor.dir/vnd.com.example.app.provider.table1 


对 于 content://com.example.app.provider/table1/1 这 个 内 容 URI， 它 所 对 应 
的 MIME 类 型 就 可 以 写成 : 


vnd.android.cursor.item/vnd.com.example.app.provider.table1 


现在 我 们 可 以 继续 完善 MyProvider 中 的 内 容 了 ， 这 次 来 实现 getType() 方 
法 中 的 逻辑 ， 代 码 如 下 所 示 : 


public class MyProvider extends ContentProvider { 


@override 
public String getType(Uri uri) { 
Switch (uriMatcher.match(uri)) { 
case TABLE1_ DIR: 
eturn "vnd.android.cursor.dir/vnd.com.example.app.provider.table1"; 
case TABLE1_ITEM: 
return "vnd.android.cursor.item/vnd.com.example.app.provider.table1"; 
case TABLE2_DIR: 
eturn "vnd.android.cursor.dir/vnd.com.example.app.provider.table2"; 
case TABLE2_ITEM: 


"vnd.android.cursor.item/vnd.com.example.app.provider.table2"; 


到 这 里 ， 一 个 完整 的 内 容 提供 器 就 创建 完成 了 ， 现 在 任何 一 个 应 用 程序 
都 可 以 使 用 ContentResolver 来 访问 我 们 程序 中 的 数据 。 那 么 前 面 所 提 到 
的 ， 如 何 才 能 保证 隐私 数据 不 会 泄漏 出 去 呢 ? 其实 多 亏 了 内 容 提 供 右 的 
民 好 机 制 ， 这 个 问题 在 不 知 不 党 中 已 经 被 解决 了 。 因 为 所 有 的 CRUD 操 
作 都 一 定 要 匹配 到 相应 的 内 容 URI 格 式 才 能 进行 的 ， 而 我 们 当然 不 可 能 
向 UriMatcher 中 添加 隐私 数据 的 URI， 所 以 这 部 分 数据 根本 无 法 被 外 部 

程序 访问 到 ， 安 全 问题 也 残 不 存在 了 。 


好 了 ， 创 建 内 容 提 供 器 的 步骤 你 也 已 经 清楚 了 ， 下 面 就 来 实战 一 下 ， 真 
正体 验 一 回路 程序 数据 共享 的 功能 。 


7.4.2 ”实现 路程 序数 据 共 胖 


简单 起 见 ， 我 们 还 是 在 上 一 章 中 DatabaseTest 项 目的 基础 上 继续 开发 ， 
通过 内 容 提供 器 来 给 它 加 入 外 部 访问 接口 。 打 开 DatabaseTest 项 目 ， 首 
先 将 MyDatabaseHelper 中 使 用 Toast 弹 出 创建 数据 库 成 功 的 提示 去 除 掉 ， 
因为 跨 程 序 访问 时 我 们 不 能 直接 使 用 Toast。 然 后 创建 一 个 内 容 提供 
器， 右 击 com.example.databasetest 包 New Other Content Provider, 
会 弹出 如 图 7.13 所 示 的 窗口 。 








Dc 


Configure Component 


人 Android Studio 


Creates a new content provider component and adds it to your Android manifest. 


Class Name: | DatabaseProvider 


URI Authorities: com.example.databasetest.provider 


Exported 
Enabled 


A semicolon separated list of one or more URI authorities that identify data under the purview of the content provider. 


| Eee 29 








图 7.13 ”创建 内 容 提 供 吉 的 窗口 


可 以 看 到 ， 这 里 我 们 将 内 容 提 供 器 命名 为 DatabaseProvider，authority 
指定 为 com.example.databasetest.provider， Exported 属 性 表示 是 否 
许 外 部 程序 访问 我 们 的 内 容 提供 器 ，Enabled 属 性 表示 是 否 启用 这 个 内 
容 提 供 器 。 将 两 个 属性 都 义 中 ， 点 击 Finish 完 成 创建 。 


接着 我 们 修改 DatabaseProvider 中 的 代码 ， 如 下 所 示 : 


public class DatabaseProvider extends ContentProvider { 











public static final int BOOK_DIR = 0; 
public static final int BOOK_ITEM = 1; 
public static final int CATEGORY_DIR = 2; 


public static final int CATEGORY_ITEM = 3; 


public static final String AUTHORITY = "com.example.databasetest.provider"; 


private static UriMatcher uriMatcher; 


private MyDatabaseHelper dbHelper; 


Static 


uriMatcher = new UriMatcher (UriMatcher .NO_MATCH); 


uriMatcher .addURI(AUTHORITY， 
uriMatcher .addURI(AUTHORITY， 
uriMatcher .addURI(AUTHORITY， 
uriMatcher .addURI(AUTHORITY， 


} 


@Override 


public boolean onCreate() { 


dbHelper = 
return true; 
站 
@override 


new MyDatabaseHelper(getContext( )， 


"book", BOOK_DIR); 

"book/#", BOOK_ITEM); 
"category", 
"category/#", CATEGORY_ITEM); 


CATEGORY_DIR); 


"BookStore.db" 


Nol 2} 


public Cursor query(Uri uri, String[] projection, String selection, String[] 
selectionArgs, String sortOrder) { 


// 查询 数据 


SQLiteDatabase db = dbHelper .getReadableDatabase(); 


Cursor cursor 
switch (uriMatcher 
case BOOK_DIR: 
cursor = d 

null, 


break; 


case BOOK_ITEM: 
String bookId 


null; 


.match(uri)) { 


b.query("Book", 


sortorder); 


projection, 


selection, 


uri.getPpathSegments().get(1); 


selectionArgs, null, 


cursor = db.query("Book", projection, "id = ?", new String[] { bookId }, 
null, null, sortOorder); 
break; 
case CATEGORY_DIR: 
cursor = db.query("Category", projection, selection, selectionArgs, 


TU 土工， 
break; 


null, 


sortorder); 


case CATEGORY_ITEM: 


String categoryId 





cursor = d 


{ categoryId }, 


break; 
default: 
break; 
} 
return cursor; 
了 
@override 


b.query("Category", 
null, null, 


和 对 基 
Sortorder ) 


public Uri insert(Uri uri, ContentValues values) { 


// 添加 数据 


SQLiteDatabase db = dbHelper .getwritableDatabase(); 
Uri uriReturn = null; 


switch (uriMatcher 
case BOOK_DIR: 
case BOOK_ITEM 


long newBookId 


.match(uri)) { 


db.insert("Book", 


uri.getPpathSegments().get(1); 
projection, 


?2", new String[] 


null, values); 


uriReturn = Uri.parse("content://" + AUTHORITY + "/book/" + 


newBook 
break; 


Id); 


case CATEGORY_DIR: 


case CATEGORY_ 
long newCa 


ITEM: 
tegoryId 


db.insert("Category", 


null, 


values); 


uriReturn = Uri.parse("content://" + AUTHORITY + "/category/" + 
newCategoryId); 


break; 
default: 
break; 
} 本 
return uriReturn; 
} 
@Override 


public int update(Uri uri, ContentValues values, String 


selectionArgs) { 
// 更 新 数据 


SQLiteDatabase db = dbHelper .getwritableDatabase(); 


int updatedRows = 
switch (uriMatcher 
case BOOK_DIR: 
updatedRow: 

break; 
case BOOK_ITEM 
String boo 
updatedRow: 
{ book 

break; 
case CATEGORY _| 
updatedRow: 
select 

break; 
case CATEGORY_ 


0; 
.match(uri)) { 


攻 二 


krd 
二 
Id }); 


DIR: 
s = 
ionArgs); 


ITEM: 


db.update("Book", 


db.update("Category", values, 


values, 


uri.getPpathSegments().get(1); 
db.update("Book", 


values, 


selection, 


"id = 2", 


selection, String[] 


selectionArgs); 


new String[] 


selection, 


String categoryId = uri.getPathSegments().get(1); 
updatedRows = db.update("Category", values, "id = ?", new String[] 
{ categoryId }); 
break; 
default: 
break; 


} 
return updatedRows; 


@Override 
public int delete(Uri uri, String selection, String[] selectionArgs) { 
// 删除 数据 
SQLiteDatabase db = dbHelper .getwritableDatabase(); 
int deletedRows = 0; 
Switch (uriMatcher.match(uri)) { 
case BOOK_DIR: 
deletedRows = db.delete("Book", selection, selectionArgs); 


break; 

case BOOK_ITEM: 
String bookId = uri. he dts get(1 和 
deletedRows = db.delete("Book", "id = ?", new String[] { bookId }); 


case CATEGORY_DIR: 
deletedRows = db.delete("Category", selection, selectionArgs); 
break; 

case CATEGORY_ITEM: 
String categoryId = = uri. get Pas Sone SC) get(1 Is 
deletedRows = db.delete("Category", "id = ?", new String[] 

{ categoryId }); 

break; 

default: 
break; 








} 
return deletedRows; 


@override 
public String getType(Uri uri) { 
Switch (uriMatcher .match(uri)) { 
case BOOK_DIR: 
return "vnd. android. cursor.dir/vnd.com.example.databasetest. 
provider .book" 
case BOOK_ITEM: 
return "vnd.android.cursor.item/vnd.com.example.databasetest. 
rovider .book"; 
case CATEGORY_DIR: 
return "vnd.android.cursor.dir/vnd.com.example.databasetest. 
rovider.category"; 
case CATEGORY_ITEM: 
turn "vnd.android.cursor.item/vnd.com.example.databasetest. 
provider.category"; 


} 
return null; 


代码 虽然 很 长 ， 不 过 不 用 担心 ， 这 些 内 容 都 非常 容易 理解 ， 因 为 使 用 到 
的 全 部 都 是 上 一 小 节 中 我 们 学 到 的 知识 。 首 先 在 类 的 一 开始 ， 同 样 是 定 
义 了 4 个 常量 ， 分 别 用 于 表示 访问 Book 表 中 的 所 有 数据 、 访 问 Book 表 中 
的 单条 数据 、 访 问 Category 表 中 的 所 有 数据 和 访问 Category 表 中 的 单条 
数据 。 然 后 在 静态 代码 块 里 对 UriMatcher 进 行 了 初始 化 操作 ， 将 期 望 匹 
配 的 几 种 URI 格 式 添 加 了 进去 。 


接 下 来 就 是 每 个 抽象 方法 的 具体 实现 了 ， 先 来 看 下 oncreate() 方 法 ， 这 
个 方法 的 代码 很 短 ， 束 是 创建 了 一 个 MyDatabaseHelper 的 实例 ， 然后 返 
人 这 时 数据 库 就 已 经 完成 了 创建 或 升 
级 操作 。 


接着 看 一 下 query() 方 法 ， 在 这 个 方法 中 先 获取 到 了 SQLiteDatabase 的 实 

















例 ， 然 后 根据 传 入 的 uri 参 数 判断 出 用 户 想 要 访问 哪 张 表 ， 再 调用 
SQLiteDatabase 的 query() 进 行 查 询 ， 并 将 cursor 对 象 返 回 就 好 了 。 注 意 
当 访 问 单 条 数据 的 时 候 有 一 个 细节 ， 这 里 调用 了 uri 对 象 的 
getPathsegments() 方 法 ， 它 会 将 内 容 URI 权 限 之 后 的 部 分 以 “/” 寂 i 
分 割 ， 并 把 分 割 后 的 经 生 打 放 入 到 一 个 字符 串 列 表 中 ， 那 这 个 列表 的 第 
个 位 置 存放 的 就 是 路 径 ， 第 1 个 位 置 存放 的 就 是 id 了 。 得 到 了 id 之 后 ， 机 
通过 selection 和 selectionArgs 参 数 进行 约束 ， 束 实现 了 查询 单条 数据 
的 功能 


再 往 后 就 是 insert() 方 法 ， 同 样 ' 的 二 

例 ， 然 后 根据 传 入 的 uri 参 数 判断 出 用 户 想 要 往 哪 张 表 里 洪 加 数据 ， 再 

调用 SQLiteDatabase 的 insert( ) 方 法 进行 添加 束 可 以 了 。 注 意 insert() 

方法 要 求 返 回 一 个 能 够 表示 这 条 新 增 数据 的 URI， 所 以 我 们 还 需要 调 

用 ur parse() 方 法 来 将 一 个 内 容 URI 解 析 成 uri 对 象 ， 当 然 这 个 内 容 URI 
是 以 新 增 数据 的 id 结 尾 的 。 


接 下 来 就 是 update() 方 法 了 ， 相 信 这 个 方法 中 的 代码 已 经 完全 难 不 倒 你 
了 。 也 是 先 获取 SQLiteDatabase 的 实例 ， 然 后 根据 传 入 的 uri 参 数 判断 出 
用 户 想 要 更 新 哪 张 表 里 的 数据 ， a 
进行 更 新 就 好 了 ， 受 影响 的 行 数 将 作为 返回 值 返 


下 面 是 delete() 方 法 ， 是 不 是 感觉 越 到 后 面 越 轻 松 了 ? 因为 你 已 经 渐 入 
佳境 ， 真 正 地 找到 和 窗 门 了 。 这 里 仍然 是 先 获 取 到 SQLiteDatabase 的 实 
例 ， 然 后 根据 传 入 的 uri 参 数 判断 出 用 户 想 要 删除 哪 张 表 里 的 数据 ， 再 
调用 SQLiteDatabase 的 delete() 方 法 进行 删除 就 好 了 ， 被 删除 的 行 数 将 
作为 返回 值 返回 


最 后 是 getType() 方 法 ， 这 个 方法 中 的 代码 完全 是 按照 上 一 节 中 介绍 的 
格式 规则 编写 的 ， 相 信 已 经 没有 什么 解释 的 必要 了 。 这 样 我 们 就 将 内 容 
提供 器 中 的 代码 全 部 编写 完 


另外 还 有 一 点 需要 注意 ， 内 容 提 供 堪 一 定 要 在 AndroidManifest.xml 文 件 
中 注册 才 可 以 使 用 。 不 过 笠 运 的 是 ， 由 于 我 们 是 使 用 Android Studio 的 快 
捷 方 式 创 建 的 内 容 提 供 器 ， 因 此 注册 这 一 步 已 经 被 自动 完成 了 。 打 开 
AndroidManifest.xml 文 件 瞧 一 瞧 ， 代 码 如 下 所 示 : 


<manifest Xm android= hp: A che android.com/apk/res/android" 
package= GEM .databa St" > 

















<applicati 
andro oid:allowpackup™" 
android:i rp Hap) ea che 


android:label="@string/app_name" 
android:supportsRtl="true 
android:theme="@style/AppTheme"> 


<provider 
android:name=" .DatabaseProvider" 
android:authorities="com.example.databasetest .provider" 
android:enabled="true" 
android:exported="true"> 
</provider> 
</application> 


</manifest> 


可 以 看 到 ，<application> 标 签 内 出 现 了 一 个 新 的 标签 <provider>， 我 们 

使 用 它 来 对 DatabaseProvider 这 个 内 容 提供 器 进行 注册 。android:name 属 

性 指定 了 DatabaseProvider 的 类 名 ，android:authorities 属 性 指定 了 

DatabaseProvider 的 authority， 而 enabled 和 exported 属 性 则 是 根据 我 们 刚 

2 - 义 选 的 状态 上 自动 生成 的 ， 这 里 表示 人 允许 DatabaseProvider 被 其 他 应 用 程 
行 访 问 。 


现在 DatabaseTest 这 个 项 目 就 已 经 拥有 了 路程 序 共享 数据 的 功能 了 ， 我 
们 赶快 来 尝试 一 下 。 首 先 需 要 将 DatabaseTest 程 序 从 模拟 器 中 删除 掉 ， 

以 防止 上 一 章 中 产生 的 遗留 数据 对 我 们 造成 干扰 。 然 后 运行 一 下 项 目 ， 

将 DatabaseTest 程 序 重 新 安装 在 模拟 器 上 了 。 接 着 关闭 掉 DatabaseTest 这 
个 项 目 ， 并 创建 一 个 新 项 目 ProviderTest， 我 们 就 将 通过 这 个 程序 去 访问 
DatabaseTest 中 的 数据 。 


还 是 先 来 编写 一 下 布局 文件 吧 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 
所 示 














<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<Button 
android:id="@+id/add_data" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Add To Book" /> 


<Button 
android:id="@+id/query_data" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Query From Book" /> 


<Button 
android:id="@+id/update_data" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Update Book" /> 





<Button 
android:id="@+id/delete_data" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Delete From Book" /> 








</LinearLayout> 





布局 文件 很 简单 ， 里 面 放置 了 4 个 按钮 ， 分 别 用 于 添加 、 碍 询 、 修 改 和 
删除 数据 。 然 后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
private String newId; 


@override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity main); 
Button addData = (Button) findViewById(R.id.add_ data); 
addData.setOonClickListener(new View.OnClickListener() { 


@Override 
public void onClick(View v) { 
// 添加 数据 
Uri uri = Uri.parse("content://com.example.databasetest. provider/ 
book"); 


ContentValues values = new ContentValues(); 
values.put("name", "A Clash of Kings"); 
values.put("author", "George Martin"); 
values.put("pages", 1040); 

values.put("price", 22.85); 

Uri newUri = getContentResolver().insert(uri, values); 
newId = newUri.getPpathSegments().get(1); 


} 
}); 
Button queryData = (Button) findvViewById(R.id.query_data); 
queryData.setonclickListener(new View.OnClickListener() { 


@Override 
public void onClick(View v) { 
// 查询 数据 
Uri uri = Uri.parse("content://com.example.databasetest. provider/ 
book"); 
Cursor cursor = getContentResolver().query(uri, null, null, null, 
null); 
if (cursor != null) { 


while (cursor.moveToNext()) { 
String name = cursor.getSstring(cursor. getColumnIndex 
("name")); 
String author = cursor.getString(cursor. getColumnIndex 
("author")); 
int pages = cursor.getInt(cursor.getColumnIndex ("pages")); 
double price = cursor.getDouble(cursor. getColumnIndex 
("price")); 
Log.d("MainActivity", "book name is " + name); 
Log.d("MainActivity", "book author is " + author); 
Log.d("MainActivity", "book pages is " + pages); 
Log.d("MainActivity", "book price is " + price); 
} 


cursor.close(); 


} 
}); 
Button updateData = (Button) findViewById(R.id.update_data); 
updateData.setOnCclickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
// 更 新 数据 
Uri uri = Uri.parse("content://com.example.databasetest. provider/ 
book/" + newId); 
ContentValues values = new ContentValues(); 
values.put("name", "A Storm of Swords"); 
values.put("pages", 1216); 
values.put("price", 24.05); 
getCcontentResolver().update(uri, values, null, null); 


}); 
Button deleteData = (Button) findViewById(R.id.delete data); 
deleteData.setonClickListener(new View.OnClickListener() { 
@override 
public void onClick(View v) { 
// 删除 数据 
Uri uri = Uri.parse("content://com.example.databasetest. provider/ 
book/" + newId); 
getCcontentResolver().delete(uri, null, null); 


}); 





可 以 看 到 ， 我 们 分 别 在 这 4 个 按钮 的 点 击 事件 里 面 处 理 了 增删 改 查 的 逻 
辑 。 添 加 数据 的 时 候 ， 首 先 调用 了 uri.parse() 方 法 将 一 个 内 容 URI 解 析 





成 uri 对 象 ， 然 后 把 要 添加 的 数据 都 存放 到 contentvalues 对 象 中 ， 接 着 
调用 contentResolver 的 insert() 方 法 执行 添加 操作 就 可 以 了 。 注 

意 insert() 方 法 会 返回 一 个 uri 对 象 ， 这 个 对 象 中 包含 了 新 增 数据 的 id， 
我 们 通过 getPathsegments() 方 法 将 这 个 id 取出 ， 稍 后 会 用 到 它 。 


查询 数据 的 时 候 ， 同 样 是 调用 了 uri.parse() 方 法 将 一 个 内 容 URI 解 析 

成 uri 对 象 ， 然后 调用 contentResolver 的 query() 方 法 去 查询 数据 ， 查询 
的 结果 当然 还 是 存放 在 cursor 对 象 中 的 。 之 后 对 cursor 进 行 珊 历 ， 从 中 
取出 查询 结果 ， 并 一 一 打印 出 来 。 


更 新 数据 的 时 候 ， 也 是 先 将 内 容 URI 解 析 成 uri 对 象 ， 然 后 把 想 要 更 新 的 
数据 存放 到 contentvalues 对 象 中 ， 再 调用 contentResolver 的 update() 
方法 执行 更 新 操作 就 可 以 了 。 注 意 这 里 我 们 为 了 不 想 让 Book 表 中 的 其 他 
行 受到 影响 ， 在 调用 uri.parse() 方 法 时 ， 给 内 容 URI 的 尾部 增加 了 一 个 
id， 而 这 个 id 正 是 添加 数据 时 所 返回 的 。 这 束 表 示 我 们 只 希望 更 新 刚刚 
添加 的 那 条 数据 ，Book 表 中 的 其 他 行 都 不 会 受 影 响 。 


删除 数据 的 时 候 ， 也 是 使 用 同样 的 方法 解析 了 一 个 以 id 结尾 的 内 容 
URI， 然 后 调用 contentResolver 的 delete() 方 法 执行 删除 操作 就 可 以 
了 。 由 于 我 们 在 内 容 URI 里 指定 了 一 个 ia， 因此 只 会 删 掉 拥 有 相应 id 的 
那 行 数据 ，Book 表 中 的 其 他 数据 都 不 会 受 影响 。 


现在 运行 一 下 ProviderTest 项 目 ， 会 显示 如 图 7.14 所 示 的 界面 。 








ProviderTest 


ADD TO BOOK 


QUERY FROM BOOK 


UPDATE BOOK 


DELETE FROM BOOK 








图 7.14 ProviderTest 主 界面 


点 击 一 下 Add To Book 按 钮 ， 此 时 数据 就 应 该 已 经 添加 到 DatabaseTest 程 
序 的 数据 库 中 了 ， 我 们 可 以 通过 点 击 Query From Book 按 钮 来 检查 一 
下 ， 打 印 日 志 如 图 7.15 所 示 。 





= > a 
| Verbose 图 (Qr ) 


com. example. providertest D/MainActivity: book name is A Clash of Kings 








com. example. providertest D/MainActivity: book author is George Martin 
com. example. providertest D/MainActivity: book pages is 1040 


com. example. providertest D/MainActivity: book price is 22.85 


图 7.15 查询 添加 的 数据 


然后 点 击 一 下 Update Book 按钮 来 更 新 数据 ， 再 点 击 一 下 Query From 
Book 按 钮 进行 检查 ， 结 果 如 图 7.16 所 示 。 


= > 二 
| Verbose 图 (Qr ) 








com. example. providertest D/MainActivity: book name is A Storm of Swords 
com. example. providertest D/MainActivity: book author is George Martin 
com. example. providertest D/MainActivity: book pages is 1216 


com. example. providertest D/MainActivity: book price is 24.05 


图 7.16 查询 更 新 后 的 数据 


最 后 点 击 Delete From Book 按 钮 删除 数据 ， 此 时 再 点 击 Query From Book 
按钮 就 查询 不 到 数据 了 。 由 此 可 以 看 出 ， 我 们 的 跨 程序 共享 数据 功能 
经 成 功 实现 了 ! 现在 不 仅 是 ProviderTest 程 序 ， 任 何 一 个 程序 都 可 以 轻松 
访问 DatabaseTest 中 的 数据 ， 而 且 我 们 还 丝 坚 不 用 担心 隐私 数据 泄漏 的 
问题 。 


到 这 里 ， 与 内 容 提 供 絮 相关 的 重要 内 容 束 基本 全 部 介绍 完了 ， 下 面 束 让 
我 们 再 次 进入 本 书 的 特殊 环节 ， 学 习 更 多 关于 Git 的 用 法 。 





7.5 ”Git 时 间 | 版 本 控制 工具 进 阶 


在 上 一 次 的 Git 时 间 里 ， 我 们 学 习 了 关于 Git 最 基本 的 用 法 ， 包 括 安装 
Git、 创 建 代码 仓库 ， 以 及 提交 本 地 代码 。 本 市 中 我 们 将 要 学 习 更 多 的 
使 用 技巧 ， 不 过 在 开始 之 前 先 要 把 准备 工作 做 好 。 


所 谓 的 准备 工作 就 是 要 给 一 个 项 目 创建 代码 仓库 ， 这 里 就 选择 在 
ProviderTest 项 目 中 创建 吧 ， 打 开 Git Bash， 进 入 到 这 个 项 目的 根 目 录 下 
面 ， 然 后 执行 git init 命 令 ， 如 图 7.17 所 示 。 











or/AndroidSstudioProjects/ProviderTest 


A 





图 7.17 创建 代码 仓库 
这 样 准 备 工作 就 已 经 完成 了 ， 让 我 们 继续 开始 Git 之 旅 吧 。 
7.5.1 忽略 文件 


代码 仓库 现在 已 经 创建 好 了 ， 接 下 来 我 们 应 该 去 提交 ProviderTest 项 目 中 
的 代码 。 不 过 在 提交 之 前 你 也 许 应 该 思考 一 下 ， 是 不 是 所 有 的 文件 都 需 
要 加 入 到 版 本 控制 当中 呢 ? 


在 第 1 章 介 绍 Android 项 目 结构 的 时 候 有 提 到 过 ，build 目 录 下 的 文件 都 是 
编译 项 目 时 自动 生成 的 ， 我 们 不 应 该 将 这 部 分 文件 添加 到 版 本 控制 当 
中 ， 那 么 如 何 才能 实现 这 样 的 效果 呢 ? 


Git 提 供 了 一 种 可 配 性 很 强 的 机 制 来 允许 用 户 将 指定 的 文件 或 目录 排除 
在 版 本 控制 之 外 ， 它 会 检查 代码 仓库 的 目录 下 是 否 存在 一 个 名 

为 .gitignore 的 文件 ， 如 果 存 在 的 话 ， 束 去 一 行 行 读 取 这 个 文件 中 的 内 
容 ， 并 把 每 一 行 指 定 的 文件 或 目录 排除 在 版 本 控制 之 外 。 注 意 .gitignore 












































中 指定 的 文件 或 目录 是 可 以 使 用 “*”" 通 配 符 的 。 


神奇 的 是 ， 我 们 并 不 需要 自己 去 创建 .gitignore 文件 ，Android Studio 在 
创建 项 目的 时 候 会 自动 帮 我 们 创建 出 两 个 .gitignore 文件 ， 一 个 在 根 目录 
下 面 ， 一 个 在 app 模 块 下 面 。 首 先 看 一 下 根 目录 下 面 的 .gitignore 文件 ， 
如 图 7.18 所 示 。 





3 .gitignore x 
*. 1ml 
.Fadle 
/local. properties 
/.idea/workspace. xml 
/.idea/libraries 
.DS _ Store 
/build 


/captures 


图 7.18 根 目录 下 面 的 .gitignore 文 件 


这 是 Android Studio 自 动 生成 的 一 些 默认 配置 ， 通 党 情况 下 ， 这 部 分 内 容 
都 是 不 用 添加 到 版 本 控制 当中 的 。 我 们 来 简单 阅读 一 下 这 个 文件 ， 除 了 
*.iml 表 示 指 定 任意 以 .iml 结 尾 的 文件 ， 其 他 都 是 指定 的 具体 的 文件 名 或 
者 目录 名 ， 上 面 配置 中 的 所 有 内 容 都 不 会 被 添加 到 版 本 控制 当中 ， 因 为 
基本 都 是 一 些 由 IDE 自 动 生成 的 配置 。 


再 来 看 一 下 app 模 块 下 面 的 .gitignore 文 件 ， 这 个 就 简单 多 了 ， 如 图 7.19 所 





引 app\.gitignore x 
/build pd 


图 7.19 ” app 模块 下 面 的 .gitignore 文 件 
由 于 app 模 块 下 面 基 本 都 是 我 们 编写 的 代码 ， 因 此 默认 情况 下 只 有 其 中 


的 build 目 录 不 会 被 添加 到 版 本 控制 当中 。 

当然 ， 我 们 完全 可 以 对 以 上 两 个 文件 进行 任意 地 修改 ， 来 满足 特定 的 需 

求 。 比 如 说 ，app 模 块 下 面 的 所 有 测试 文件 都 只 是 给 我 自己 使 用 的 ， 我 

ee 
内容: 


没 错 ， 只 需 添 加 这 样 两 行 配置 ， 因 为 所 有 的 测试 文件 都 是 放 在 这 两 个 目 
录 下 的 。 现 在 我 们 可 以 提交 代码 了， 先 使 用 add 命 令 将 所 有 的 文件 进行 
添加 ， 如 下 所 示 : 


git add . 


然后 执行 commit 命 令 完成 提交 ， 如 下 所 示 : 


git commit -m "First commit." 





7.5.2 ”查看 修改 内 容 


在 进行 了 第 一 次 代码 提交 之 后 ， 我 们 后 面 还 可 能 会 对 项 目 不 断 地 进行 维 
护 或 添加 新 功能 等 。 比 较 理 想 的 情况 是 每 当 完 成 了 一 小 块 功能 ， 就 执行 
一 次 提交 。 但 是 如 宋 茶 个 功能 牵扯 到 的 代码 比较 多 ， 有 可 能 写 到 后 面 的 
时 候 我 们 就 已 经 乐 记 前 面 修改 了 什么 东西 了 。 遇 到 这 种 情况 时 不 用 担 

心 ，Git 全 都 帮 你 记 着 呢 ! 下 面 我 们 惑 来 学 习 一 下 如 何 使 用 Git 来 得 看 目 
上 次 提交 后 文件 修改 的 内 容 。 


查看 文件 修改 情况 的 方法 非常 简单 ， 只 需要 使 用 status 命 令 就 可 以 了 ， 
在 项 目的 根 目录 下 输入 如 下 命令 : 


git status 























然后 Git 会 提示 目前 项 目 中 没有 任何 可 提交 的 文件 ， 因 为 我 们 刚刚 才 提 
交 过 呆 。 现 在 对 ProviderTest 项 目 中 的 代码 稍 做 一 下 改动 ， 修 改 


MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
G@override 
protected void onCreate(Bundle SavedInstanceState) { 
addData.setonCclickListener(new OnCclickListener() { 
Q@override 
public void onClick(View v) { 


values.put("price", 55.55); 


这 里 仅仅 是 在 添加 数据 的 时 候 ， 将 书 的 价格 由 22.85 改 成 了 55.55。 然 后 
重新 输入 git status 命令， 这 次 结果 如 图 7.20 所 示 。 


master 
Changes not staged for commit: 


(use “git add <file>... ”to update what will be commtted) 
(use “git checkout -- <file>..." to discard changes in working directory) 





no changes added to commit (use “git add™” and/or “git commit -a”) 
图 7.20 查看 文件 变动 情况 


可 以 看 到 ，Git 提 醒 我 们 MainActivity.java 这 个 文件 已 经 发 生 了 更 改 ， 那 
么 如 何 才 能 看 到 更 改 的 内 容 呢 ?这 就 需要 借助 diff 命 令 了 ， 用 法 如 下 所 
修 \: 


git diff 


这 样 可 以 查看 到 所 有 文件 的 更 改 内 容 ， 如 果 你 只 想 查 看 
MainActivity.java 这 个 文件 的 更 改 内 容 ， 可 以 使 用 如 下 命令 : 


git diff app/src/main/java/com/example/providertest/MainActivity.java 


命令 的 执行 结果 如 图 7.21 所 示 。 


$ git diff app/src/main/Java/ com examp] 已/ pr OV ridertes t/Mai nActivity. java 
VA A et et Java b/app/src/ 
main/ /java/com/example/providertest/MainActivity. Java 
index 611ffle. -3fc46b7 100644 
--- a/app/src/main/ ‘Java/ Com/examp1e/Aprovidertest/ MainActivity. Java 
+++ byappysrcymainy/ Java/ com/ xample,/ ‘providertest/ 'M nActivity. erie 

S MainAct1 Vity extend Ep npatAct7 

"A Cl ash of K17 


s. put (“autho ""， "George Mart1 ins]3 
values.put("pages”, 1040); 


Jri newUri = getContentResolver ().1insert(uri, val 
ewId = newUr1.getPathSegments() .get(1); 





图 7.21 查看 修改 的 具体 内 容 

其 中 ， 减 号 代表 删除 的 部 分 ， 加 号 代表 添加 的 部 分 。 从 图 中 我 们 就 可 以 
明显 地 看 出 ， 书 的 价格 由 22.85 被 修改 成 了 55.55。 

7.5.3 ”撤销 未 提交 的 修改 


有 亲人 优 我 们 的 代 介 可 能 会 汪 得 过 于 二 以 至 于 原本 正常 的 功能 ， 结 果 
反倒 被 我 们 改 出 了 问题 。 遇 到 这 种 情况 时 也 不 用 着急 ， 因 为 只 要 代码 还 
未 提交 ， 所 有 修改 的 内 容 部 是 可 以 撤销 的 。 


比如 在 上 一 小 市 中 我 们 修改 了 MainActivity 里 一 本 书 的 价格 ， 现 在 如 果 
想 要 撤销 这 个 修改 就 可 以 使 用 checkout 命 令 ， 用 法 如 下 所 示 : 


git checkout app/src/main/java/com/example/providertest/MainActivity.java 








执行 了 这 个 命令 之 后 ， 我 们 对 MainActivityjava 这 个 文件 所 做 的 一 切 修 
了 重新 运行 git status 命令 检 查 一 下 ， 结 果 如 图 
7.22 有 六 不 。 


$ git status 


On branch master 
nothing to commit, working directory clean 





图 7.22 重新 查看 文件 变动 情况 


| 当前 项 目 中 没有 任何 可 提交 的 文件 ， 说 明 撤 销 操 作 确 实 是 成 
J 


不 过 这 种 撤销 方式 只 运用 于 那些 还 没有 执行 过 add 命 令 的 文件 ， 如 果 某 
过 了 ， 这 种 方式 就 无 法 撤销 其 更 改 的 内 容 ， 我 们 来 做 
上 试验 瞧 一 瞧 。 


首先 仍然 是 将 MainActivity 中 那 本 书 的 价格 改 成 55.55， 然 后 输入 如 下 命 


git add . 


这 样 就 把 所 有 修改 的 文件 都 进行 了 添加 ， 可 以 输入 git status 来 检查 一 
下 ， 结 果 如 图 7.23 所 示 。 


$ git status 
On branch master 
Changes to be committed: 


(use “git reset HEA D <file>...” to unstage) 





图 7.23 再 次 查看 文件 变动 情况 


现在 我 们 再 执行 一 表 checkout 命 令 ， 你 会 发 现 MainActivity 仍 然 是 处 于 
己 添 加 状态 ， 所 修改 的 内 容 无 法 撤销 挥 。 


这 种 情况 应 该 怎么 办 ? 难道 我 们 还 没 法 后 悔 了 ? 当然 不 是 ， 只 不 过 对 于 
己 添 加 的 文件 我 们 应 该 先 对 其 取消 添加 ， 然后 才 可 以 撤回 提交 。 取 消 添 
加 使 用 的 是 reset 命 令 ， 用 法 如 下 所 示 : 


git reset HEAD app/src/main/java/com/example/providertest/MainActivity.java 





然后 再 运行 一 授 git status 命 令 ， 你 就 会 发 现 MainActivity.java 这 个 文件 
和 章 新 变 回 了 未 添加 状态 ， 此 时 就 可 以 使 用 checkout 命 令 来 将 修改 的 内 容 
进行 撤销 了 。 


7.5.4 ”查看 提交 记录 


当 ProviderTest 这 之 个 项 目 开发 了 几 个 月 之 后 ， 我 们 可 能 已 经 执行 过 上 百 次 
的 提交 操作 了 ， 这 个 时 候 估 计 你 早 就 已 经 筷 记 每 次 提交 都 修改 了 哪些 内 

















容 。 不 过 没关系 ， 忠实 的 Git 一 直 都 玫 我 们 清 清楚 楚 地 记录 着 昵 | 可 以 
使 用 1og 命 令 查 看 历史 提交 信 言 息 ， 用 法 如 下 所 示 : 


git log 


由 于 目前 我 们 只 执行 过 一 次 提交 ， 所 以 能 看 到 的 信息 很 少 ， 如 图 7.24 所 
外。 


or: Tony <tonyGgmal | . Conr 


77 


Sun May 22 了 9 :18:36 2016 +0800 


First commit. 





图 7.24 查看 提交 记录 


可 以 看 到 ， 每 次 提交 记录 都 会 包含 提交 id、 提 交 人 、 提 交 日 期 以 及 提交 
描述 这 4 个 信息 。 那 么 我 们 再 次 将 书 价 修改 成 55.55， 然后 执行 一 次 提交 
操作 ， 如 下 所 示 : 


git add . 
git commit -m "Change price." 


现在 重新 执行 git 1og 命 令 ， 络 果 如 图 7.25 所 示 。 


$ git log 


Author: Tony <tony admai] 。COW 
Date: Sun May 22 19:21:49 2016 +0800 


Change price 


Author : Tony < at1] . conr 
Date: Sun May 22 19:18:36 2016 +0800 


First commit. 





图 7.25 重新 查看 提交 记录 


当 提 交 记 录 非 常 多 的 时 候 ， 如 果 我 们 只 想 得 看 其 中 一 条 记录 ， 可 以 在 命 
令 中 指定 该 记录 的 id， 并 加 上 -1 参数 表示 我 们 只 想 看 到 一 行 记录 ， 各 下 
所 示 : 


git log 1fa380b502a00b82bfc8d84c5ab5e15b8fbf7dac -1 


而 如 末 息 要 仿 丰 这 条 近 交 记录 具 \ 体 修改 了 什么 内 容 ， 可 以 在 命令 中 加 
入 -p 参 数 ， 命 令 如 下 : 


git log 1fa380b502a00b82bfc8d84c5ab5e15b8fbf7dac -1 -p 





I 主 果 如 图 7.26 所 示 ， 其 中 减 写 代表 删除 的 部 分 ， 加 号 代表 添加 
部 分 。 


Author 》 》 
Date: Sun May 22 :21:49 2016 +0800 
Change price 
diff --git a/app/src/main/jJava/com/example/providertest/MainActivity.Java b/app/src/main/jJava/com 
/example/providertest/MainActivity. ]ava 


index 611ffle. . 7aa7d21 100644 
--- al/ ‘app/ src/ ‘main/ "Java/ ‘com/example/providertest/MainActivity. java 


十 十 十 byappy src/main/ Java/ com/example/providertest/ MainActivity. Java 
ss MainAct1 y extends ompatActivity { 
E l! 


Uri newUr1 = getContentResolver().insert(ur1, values); 
newId = newUr1.getPathSegments() .get(1); 





图 7.26 查看 提交 记录 的 具体 修改 内 容 


lk. 本 次 的 Git 时 间 束 到 这 里 ， 下 面 我 们 来 对 本 章 中 所 学 的 知识 做 个 
回顾 吧 。 





7.6 小结 与 点评 


本 章 的 内 容 不 算 多 ， 而 且 很 多 时 候 都 是 在 使 用 上 一 章 中 学 习 的 数据 库 知 
识 ， 所 以 理解 这 部 分 内 容 对 你 来 说 应 该 是 比较 轻松 的 吧 。 在 本 章 中 ， 我 
们 一 开始 先 了 解 了 Android 的 权限 机 制 ， 并 且 学 会 了 如 何在 6.0 以 上 的 系 
统 中 使 用 运行 时 权限 ， 然 后 又 重点 学 习 了 内 容 提供 器 的 相关 内 容 ， 以 实 
现 路 程序 数据 共享 的 功能 。 现 在 你 不 仅 知 道 了 如 何 去 访 问 其 他 程序 中 的 
人 
J 吧 。 


不 过 每 次 在 创建 内 容 提供 器 的 时 候 ， 你 都 需要 提醒 一 下 自己 ， 我 是 不 是 
应 该 这 么 做 ?因为 只 有 真正 需要 将 数据 共享 出 去 的 时 候 我 们 才 应 该 创建 
内 容 提供 器 ， 仅 仅 是 用 于 程序 内 部 访问 的 数据 束 没 有 必要 这 么 做 ， 所 以 
干 万 别 对 它 进行 滥用 。 


在 连续 学 了 几 半 系统 机 制 方面 的 内 容 之 后 是 不 是 感觉 有 些 枯燥 ? 那么 下 
一 半 中 我 们 就 来 换 换 口 味 ， 学 习 一 下 Android 多 媒体 方面 的 知识 吧 。 


























第 8 草 丰 调 你 的 程序 - 运用 手机 
多 巡 体 


在 过 去 ， 手 机 的 功能 都 比较 单调 ， 仅 仅 就 是 用 来 打 电 话 和 发 短信 的 。 而 
如 今 ， 手 机 在 我 们 的 生活 中 正 扮演 着 越 来 越 重 要 的 角色 ， 各 种 娱乐 方式 
都 可 以 在 手机 上 进行 。 上 班 的 路 上 太 无 聊 ， 可 以 戴 着 耳机 听 音 乐 。 外 出 
旅行 的 时 候 ， 可 以 在 手机 上 看 电影 。 无 论 走 到 哪里 ， 遇 到 喜欢 的 事物 都 
可 以 随手 拍 下 来 。 


众多 的 娱乐 方式 少不了 强大 的 多 媒体 功能 的 文 持 ， 而 Android 在 这 方面 
也 做 得 非常 出 色 。 它 提供 了 一 系列 的 API， 使 得 我 们 可 以 在 程序 中 调用 
很 多 手机 的 多 媒体 资源 ， 从 而 编写 出 更 加 丰富 多 彩 的 应 用 程序 ， 本 章 我 
们 就 将 对 Android 中 一 些 和 常用 的 多 媒体 功能 的 使 用 技巧 进行 学 习 。 


前 面 的 7 章 内 容 ， 我 们 一 直 都 是 使 用 模拟 喜来 运行 程序 的 ， 不 过 本 章 涉 
及 的 一 些 功能 必须 要 在 真正 的 Android 手 机 上 运行 才 看 得 到 效果 。 
此 ， 首 先 我 们 就 来 学 习 一 下 ， 如 何 使 用 Android 手 机 来 运行 程序 。 











8.1 将 程序 运行 到 手机 上 


不 必 我 多 说 ， 首 先 你 需要 拥有 一 部 Android 手 机 。 现 在 Android 手 机 早 就 
人 
购买 吧 。 


想 要 将 程序 运行 到 手机 上 ， 我 们 需要 先 通过 数据 线 把 手机 连接 到 电脑 
上 。 然 后 进入 到 设置 ~ 开发 者 选项 界面 ， 并 在 这 个 界面 中 勺 选 中 USB 调 
试 选项 ， 如 图 8.1 所 示 。 





ya 


所 开发 者 选项 


开启 





调试 
USB 调 试 
车 榜 USB 后 启用 调试 模式 总 


撤消 USB 调 试 授权 


错误 报告 快捷 方式 
在 电源 菜单 中 显示 用 于 提交 错误 报告 的 技 


选择 模拟 位 置信 息 应 用 
未 设置 模拟 位 置信 息 应 用 


启用 视图 属性 检查 功能 


选择 调试 应 用 


图 8.1 启用 USB 调 试 

注意 从 Android 4.2 系 统 开 始 ， 开 发 者 选项 默认 是 隐藏 的 ， 你 需要 先进 入 
到 “关于 手机 ”界面 ， 然 后 对 着 最 下 面 的 版 本 号 那 一 栏 连续 点 击 ， 就 会 让 
开发 者 选项 显示 出 来 。 





然后 如 果 你 使 用 的 是 Windows 操 作 系 统 ， 还 需要 在 电脑 上 安装 手机 的 驱 
动 。 一 般 借助 360 手 机 助手 或 统 豆 羡 等 工具 都 可 以 快速 地 进行 安装 ， 安 
装 完 成 后 就 可 以 看 到 手机 已 经 连接 到 电脑 上 了 ， 如 图 8.2 所 示 。 








手机 定期 体检 ， 保持 最 佳 状态 


木马 手机 病 辫 ， 优 化 手机 运行 速度 ,清理 手机 垃 燃 


管理 预 装 软 位 
48 





CO 新 包 玫 并 


下 加 有 你 喜欢 的 游戏 堵 


图 8.2 手机 成 功 连接 上 电脑 
-个 日 


现在 观察 Android Monitor， 你 会 发 现 当前 是 有 两 个 设备 在 线 的 ， 站 是 
我 们 一 直 使 用 的 模拟 器 ， 男 外 一 个 则 是 刚刚 连接 上 的 手机 了 ， 如 图 8.3 


所 示 。 


Android Monitor 


加 LGE Nexus 5 Android 6.0.1, API 23 - 


El | 一 Emulator Nexus_5X_API 24 Android 7.0, API 24 


加 LGE Nexus 5 Androtd 6.0.1 API 23 
图 8.3 在 线 设备 列表 


然后 运行 一 下 当前 项 目 ， 这 时 不 会 直接 将 程序 运行 到 模拟 器 或 者 手机 
上 ， 而 是 会 弹出 一 个 对 话 框 让 你 进行 选择 ， 如 图 8.4 所 示 。 








网 Select Deployment Target 
Connected Devices 
加 Nexus 5X API 24 (Android 7.0, API 24) 


LGE Nexus 5 (Androld 6.0.1 API 23) 








Create New Virtual Device Don't see your device? 





| [) Use same selection for future launches 


图 8.4 选择 运行 设备 对 话 框 
选中 下 面 的 LGE Nexus 5 后 点 击 OK， 就 会 将 程序 运行 到 手机 上 了 。 


8.2 ”使 用 通知 


通知 CNotification) 是 Android 系 统 中 比较 有 特色 的 一 个 功能 ， 当 某 个 应 
用 程序 希望 向 用 户 发 出 一 些 提示 信息 ， 而 该 应 用 程序 又 不 在 前 台 运 行 
时 ， 就 可 以 借助 通知 来 实现 。 发 出 一 条 通知 后 ， 手 机 最 上 方 的 状态 栏 中 
会 显示 一 个 通知 的 图 标 ， 下 拉 状 态 栏 后 可 以 看 到 通知 的 详细 内 容 。 
Android 的 通知 功能 获得 了 大 量 用 户 的 认可 和 喜爱 ， 丈 连 iOS 系 统 也 在 5.0 
版 本 之 后 加 入 了 类 似 的 功能 。 


8.2.1 通知 的 基本 用 法 


本 解 了 通知 的 基本 概念 ， 下 面 我 们 残 来 看 一 下 通知 的 使 用 方法 吧 。 通 知 
的 用 法 还 是 比较 灵活 的 ， 既 可 以 在 活动 里 创建 ， 也 可 以 在 广播 接收 器 里 
创建 ， 当 然 还 可 以 在 下 一 章 中 我 们 即将 学 习 的 服务 里 创建 。 相 比 于 广播 
接收 费 和 服务 ， 在 活动 里 创建 通知 的 场景 还 是 比较 少 的 ， 因 为 一 般 只 有 
当 程 序 进入 到 后 人 台 的 时 候 我 们 才 需 要 使 用 通知 。 


不 过 ， 无 论 是 在 哪里 创建 通知 ， 整 体 的 步骤 都 是 相同 的 ， 下 面 我 们 就 来 
学 习 一 下 创建 通知 的 详细 步骤 。 首 先 需 要 一 个 NotificationManager 来 对 
通知 进行 管理 ， 可 以 调用 Context 的 getsystemservice() 方 法 获取 

到 。getsystemService() 方 法 接收 一 个 字符 串 参数 用 于 确定 获取 系统 的 
哪个 服务 ， 这 里 我 们 传 入 context .NOTIFICATION_SERVICE 即 可 。 因 此 ， 
获取 NotificationManager 的 实例 束 可 以 写成 : 





NotificationManager manager = (NotificationManager) getSystemService(Context .NOTIFICATION_SERVICE) ; 


接 下 来 需要 使 用 一 个 Builder 构 造 器 来 创建 Notification 对 象 ， 但 问题 在 
于 ， 几 乎 Android 系 统 的 每 一 个 版 本 都 会 对 通知 这 部 分 功能 进行 或 多 或 
少 的 修改 ，API 不 稳定 性 问题 在 通知 上 面 突显 得 尤其 严重 。 那 么 该 如 何 
解决 这 个 问题 呢 ?” 其 实 解 决 方案 我 们 之 前 已 经 见 过 好 几 回 了 ， 束 是 使 用 
support 库 中 提供 的 兼容 API。support-v4 库 中 提供 了 一 

个 Notificationcompat 类 ， 使 用 这 个 类 的 构造 器 来 创建 Notification 对 
象 ， 就 可 以 保证 我 们 的 程序 在 所 有 Android 系 统 版 本 上 都 能 正常 工作 
了 ， 代 码 如 下 所 示 : 








Notification notification = new NotificationCompat.Builder(context).build(); 


当然 ， 上 述 代码 只 是 创建 了 一 个 空 的 Notification 对 象 ， 并 没有 什么 实 
际 作用 ， 我 们 可 以 在 最 终 的 build() 方 法 之 前 连 缀 任意 多 的 设置 方法 来 
创建 一 个 丰富 的 Notification 对 象 ， 先 来 看 一 些 最 基本 的 设置 : 


Notifi cot on Uo fication = new NotificationCompat .Builder(context) 
et . is content title" 








上 述 代码 中 一 共 调 用 了 5 个 设置 方法 ， 下 面 我 们 来 一 一 解析 一 

下 。setcontentTitle() 方 法 用 于 指定 通知 的 标题 内 容 ， 下 拉 系 统 状态 栏 
就 可 以 看 到 这 部 分 内 容 。setcontentText() 方 法 用 于 指定 通知 的 正文 内 
容 ， 同 样 下 拉 系 统 状态 栏 就 可 以 看 到 这 部 分 内 容 。setwhen() 方 法 用 于 

指定 通知 被 创建 的 时 间 ， 以 宣 秒 为 单位 ， 当 下 拉 系 统 状态 栏 时 ， 这 里 指 
定 的 时 间 会 显示 在 相应 的 通知 上 。setsmallIcon() 方 法 用 于 设置 通知 的 
小 图 标 ， An a 小 图 标 会 显示 在 系 
统 状态 栏 上。setLargeIcon() 方 法 用 于 设置 通知 的 大 图 标 ， 当 下 拉 系 统 
状态 栏 时 ， 就 可 以 看 到 设置 的 大 图 标 了 。 


以 上 工作 都 完成 之 后 ， 只 只 需要 调用 NotificationManager 的 notify( ) 方 法 
就 可 以 让 通知 显示 出 来 了 。notify() 方 法 接收 两 个 参数 ， 第 一 个 参数 
是 id， 要 保证 为 每 个 通知 所 指定 的 id 都 是 不 同 的 。 第 二 个 参数 则 

是 Notification 对 象 ， 这 里 直接 将 我 们 刚刚 创建 好 的 Notification 对 象 
传 入 即 可 。 因 此 ， 显 示 一 个 通知 束 可 以 写成 : 


manager .notify(1, notification); 


到 这 里 就 已 经 把 创建 通知 的 每 一 个 步骤 都 分 析 完 了 ， 下 面 就 让 我 们 通过 
一 个 具体 的 例子 来 看 一 看 通 知 到 底 是 长 什么 样 的 。 


新 建 一 个 NotificationTest 项 目 ， 并 修改 activity_main.xml 中 的 代码 ， 如 下 
所 示 : 


<LinearLayout xmln nar 01 a Ne //schemas.android.com/apk/res/android" 
i rien 


<Button 
android:id="@+id/send_notice" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="Send notice" /> 


</LinearLayout> 





布局 文件 非常 简单 ， 里 面 只 有 一 个 Send ” notice 按钮 ， 用 于 发 出 一 条 通 
知 。 接 下 来 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceSstate); 
setContentView(R.1layout.activity_ main); 
Button sendNotice = (Button) findViewById(R.id.send_ notice); 
sendNotice.setOonClickListener(this); 


} 


@Override 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.send notice: 
NotificationManager manager = (NotificationManager) getSystemService 
(NOTIFICATION_SERVICE); 

Notification notification = new NotificationCompat. Builder(this) 
.SetcontentTitle("This is content title") 
.SetContentText("This is content text") 
.Setwhen(System.currentTimeMillis()) 
.SetsmallIcon(R.mipmap.ic_launcher) 
.SetLargeIcon(BitmapFactory.decodeResource(getResources(), 

R.mipmap.ic_launcher)) 


.build 
manager .notify(1, notification); 
brea 
default: 
break 


可 以 看 到 ， 我 们 在 Send notice 按 钮 的 点 击 事件 里 面 完 成 了 通知 的 创建 工 
作 ， 创 建 的 过 程 正 如 前 面 所 描述 的 一 样 。 不 过 这 里 简单 起 见 ， 我 将 通知 
栏 的 大 小 图 都 直接 设置 成 了 ic_ launcher 这 张 图 ， 这 样 就 不 用 再 去 专门 准 
备 图 标 了 ， 而 在 实际 项 目 中 干 万 不 要 这 样 偷懒 。 


现在 可 以 来 运行 一 下 程序 了 ， 点 击 Send notice 按 钮 ， 你 会 在 系统 状态 栏 
的 最 左边 看 到 一 个 小 图 标 ， 如 图 8.5 所 示 。 
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SEND NOTICE 


图 8.5 通知 的 小 图 标 
下 拉 系 统 状态 栏 可 以 看 到 该 通知 的 详细 信息 ， 如 图 8.6 所 示 。 


This is content title 
his Is content text 





图 8.6 通知 的 详细 信息 


如 果 你 使 用 过 Android 手 机 ， 此 时 应 该 会 下 意识 地 认为 这 条 通知 是 可 以 
点 击 的 。 但 是 当 你 去 点 击 它 的 时 候 ， 你 会 发 现 没有 任何 效 末 。 不 对 啊 ， 
好 像 每 条 通知 点 击 之 后 都 应 该 会 有 反应 的 呀 ? 其 实 要 想 实现 通知 的 点 击 
效果 ， 我 们 还 需要 在 代码 中 进行 相应 的 设置 ， 这 就 涉及 了 一 个 新 的 概 


念 : PendingIntent。 


PendingIntent 从 名 字 上 看 起 来 就 和 Intent 有 些 类 似 ， 它 们 之 间 也 确实 存在 
着 不 少 共同 点 。 比 如 它们 都 可 以 去 指明 某 一 个 “意图 ”*”， 都 可 以 用 于 启动 





活动 、 启 动 服务 以 及 发 送 广 播 等 。 不 同 的 是 ，Intent 更 加 倾 回 于 去 立即 
执行 某 个 动作 ， 而 PendingIntent 更 加 倾 同 于 在 茶 个 合适 的 时 机 去 执行 某 
个 动作 。 所 以 ， 也 可 以 把 PendingIntent 简 单 地 理解 为 延迟 执行 的 Intent。 


PendingIntent 的 用 法 同样 很 简单 ， 它 主要 提供 了 几 个 静态 方法 用 于 获取 
PendingIntent 的 实例 ， 可 以 根据 需求 来 选择 是 使 用 getActivity() 方 
法 、getBroadcast() 方 法 ， 还 是 getservice() 方 法 。 这 几 个 方法 所 接收 
的 参数 都 是 相同 的 ， 第 一 个 参数 依旧 是 context， 不 用 多 做 解释 。 第 二 
个 参数 一 般 用 不 到 ， 通 常 都 是 传 入 0 即 可 。 第 三 个 参数 是 一 个 Intent 对 
象 ， 我 们 可 以 通过 这 个 对 象 构建 出 PendingIntent 的 “意图 ”。 第 四 个 参数 
用 于 确定 PendingIntent 的 行为 ， 

有 FLAG_ONE_SHOT、 FLAG_NO_CREATE、 FLAG_CANCEL_CURRENT 和 
FLAG_UPDATE_CURRENT 这 4 种 值 可 选 ， 每 种 值 的 具体 含义 你 可 以 查看 文 
档 ， 通 常情 况 下 这 个 参数 传 入 0 就 可 以 了 。 


对 PendingIntent 有 了 一 定 的 了 解 后 ， 我 们 再 回 过 头 来 看 一 

下 NotificationCcompat .Builder。 这 个 构造 器 还 可 以 再 连 绥 一 

个 setcontentIntent() 方 法 ， 接 收 的 参数 正 是 一 个 PendingIntent 对 象 。 
因此 ， 这 里 就 可 以 通过 PendingIntent 构 建 出 一 个 延迟 执行 的 “意图 ”， 当 
用 户 点 击 这 条 通知 时 就 会 执行 相应 的 逻辑 。 


现在 我 们 来 优化 一 下 NotificationTest 项 目 ， 给 刚才 的 通知 加 上 点 击 功 
能 ， 让 用 户 点 击 它 的 时 候 可 以 启动 男 一 个 活动 。 


首先 需要 准备 好 男 一 个 活动 ， 右 击 com.example.notificationtest 包 
-New 一 Activity Empty Activity， 新 建 NotificationActivity， 布 局 起 名 


为 notification_layout。 然 后 修改 notification_layout.xml 中 的 代码 ， 如 下 所 
砂 : 


lns:android="http://schemas.android.com/apk/res/android" 
i ="match_parent" 


t="match_parent" 条 


这 样 就 把 NotificationActivity 这 个 活动 准备 好 了 ， 下 面 我 们 修改 
MainActivity 中 的 代码 ， 给 通知 加 入 点 击 功 能 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


@override 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.send _ notice: 

Intent intent = new Intent(this, NotificationActivity.class); 

PendingIntent pi = PendingIntent.getActivity(this, 0, intent, 0) 

NotificationManager manager = (NotificationManager) getSystemService 

(NOTIFICATION_SERVICE); 

Notification notification = new NotificationCompat.Builder(this) 
.SetcontentTitle("This is content title") 
.SetContentText("This is content text") 
.Setwhen(System.currentTimeMillis()) 
.SetsmallIcon(R.mipmap.ic_launcher) 
.SetLargeIcon(BitmapFactory.decodeResource(getResources(), 

R.mipmap.ic_launcher)) 


:setContentIntent (pi) 
‘build 
manager. notify(1, notification); 
brea 
default: 
break 


可 以 看 到 ， 这 里 先是 使 用 Intent 表 达 出 我 们 想 要 局 动 NotificationActivity 
的 “意图 ”， 然 后 将 构建 好 的 Intent 对 象 传 入 到 PendingIntent 的 
getActivity() 方 法 里 ， 以 得 到 PendingIntent 的 实例 ， 接 着 

在 NotificationCcompat .Builder 中 调用 setcontentIntent() 方 法 ， 把 它 作 
为 参数 传 入 即 可 。 


现在 重新 运行 一 下 程序 ， 并 点 击 Send notice 按钮 ， 依 旧 会 发 出 一 条 通 
知 。 然 后 下 拉 系 统 状 态 栏 ， 点 击 一 下 该 通知 ， 就 会 看 到 
NotificationActivity 这 个 活动 的 界面 了 ， 如 图 8.7 所 示 。 








NotificationTest 


This is notification layout 








图 8.7 点 击 通 知 后 打开 NotificationActivity 界 面 


喷 ? 怎么 系统 状态 上 的 通知 图 标 还 没有 消失 呢 ? 是 这 样 的 ， 如 果 我 们 没 
有 在 代码 中 对 该 通知 进行 取消 ， 它 就 会 一 直 显 示 在 系统 的 状态 栏 上 。 解 
决 的 方法 有 两 种 ， 一 种 是 在 Notificationcompat .Builder 中 再 连 缕 一 
个 setAutocancel() 方 法 ， 一 种 是 显 式 地 调用 NotificationManager 的 
cancel() 方 法 将 它 取 消 ， 两 种 方法 我 们 都 学 习 一 下 。 


AAA 站 ™ 二 大 
= 坑 等 
第 一 种 方法 写法 如 下 : 
Notification notification = new NotificationCompat.Builder(this) 


.SetAutoCancel(true) 
.build()， 


可 以 看 到 ，setAutocancel() 方 法 传 入 true， 就 表示 当 点 击 了 这 个 通知 的 


时 候 ， 通 知 会 自动 取消 掉 。 
第 二 种 方法 写法 如 下 : 


public class NotificationActivity extends AppCompatActivity { 


verride 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.notification_layout); 
| = (NotificationManager) getSystemService 


} 
} 





这 里 我 们 在 cancel() 方 法 中 传 入 了 1， 这 个 1 是 什么 意思 呢 ? 还 记得 在 创 
建 通知 的 时 候 给 每 条 通知 指定 的 id 吗 ? 当时 我 们 给 这 条 通知 设置 的 id 就 
是 1。 因 此 ， 如 果 你 想 取 消 哪 条 通知 ， 在 cancel( ) 方 法 中 传 入 该 通知 的 id 
就 行 了 。 


8.2.2 ”通知 的 进 阶 技巧 


现在 你 已 经 掌握 了 创建 和 取消 通知 的 方法 ， 并 且 知 道 了 如 何 去 啊 应 通知 
的 反击 事件 。 不 过 通知 的 用 法 并 不 仅仅 是 这 些 呢 ， 下 面 我 们 整 来 探 完 一 
下 通知 的 更 多 技巧 。 


上 一 小 节 中 创建 的 通知 属于 最 基本 的 通知 ， 实 际 

上 ，NotificationCcompat .Builder 中 提供 了 非常 丰富 的 API 来 让 我 们 创建 
出 更 加 多 样 的 通知 效果 。 当 然 ， 每 一 个 API 都 详细 地 讲 一 过 不 太 可 能 ， 
我 们 只 能 从 中 选 一 些 比较 常用 的 API 来 进行 学 习 。 先 来 看 看 setsound() 
方法 吧 ， 它 可 以 在 通知 发 出 的 时 候 播 放 一 段 音频 ， 这 样 束 能 够 更 好 地 告 
知 用 户 有 通知 到 来 。setsound() 方 法 接收 一 个 uri 参 数 ， 所 以 在 指定 音 
频 文 件 的 时 候 还 需要 先 获取 到 音频 文件 对 应 的 URI。 比 如 说 ， 每 个 手机 
的 /system/media/audio/ringtones 目 录 下 都 有 很 多 的 音频 文件 ， 我 们 可 以 
从 中 随便 选 一 个 音频 文件 ， 那 么 在 代码 中 就 可 以 这 样 指 定 : 


Notification notification = new NotificationCompat.Builder(this) 











.SetSound(Uri.fromFile(new File("/system/media/audio/ringtones/Luna.ogg"))) 
.build(); 


除了 允许 播放 音频 外 ， 我 们 还 可 以 在 通知 到 来 的 时 候 让 手机 进行 振动 ， 
使 用 的 是 vibrate 这 个 属性 。 它 古 一 个 长 整 型 的 数组 ， 用 于 设置 手机 静 
止 和 振动 的 时 长 ， 以 旱 秒 为 单位 。 下 标 为 0 的 值 表示 手机 静止 的 时 长 ， 


下 标 为 1 的 值 表示 手机 振动 的 时 长 ， 下 标 为 2 的 值 又 表示 手机 静止 的 时 
长 ， 以 此 类 推 。 所 以 ， 如 果 想 要 让 手机 在 通知 到 来 的 时 候 立 刻 振动 1 
秒 ， 然 后 静止 1 秒 ， 再 振动 1 秒 ， 代 码 就 可 以 写成 : 


Notification notification = new NotificationCompat.Builder(this) 


.SetVibrate(new long[] {0, 1000, 1000, 1000 }) 
build(); 





不 过 ， 想 要 控制 手机 振动 还 需要 声明 权限 。 因 此 ， 我 们 还 得 编辑 
AndroidManifest xml 文 件 ， 加 入 如 下 声明 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
y mple.notificationtest" 


uses-permission android:name="android.permission.VIBRATE" /> 





学 会 了 控制 通知 的 声音 和 振动 ， 下 面 我 们 来 看 一 下 如 何在 通知 到 来 时 控 
制 手机 LED 灯 的 显示 。 


现在 的 手机 基本 上 都 会 前 置 一 个 LED 灯 ， 当 有 未 接 电 话 或 未 读 短 信 ， 而 
此 时 手机 又 处 于 锁 屏 状态 时 ，LED 灯 就 会 不 停 地 闪烁 ， 提 醒 用 户 去 查 

有 六 我 们 可 以 使 用 setLights() 方 法 来 实现 这 种 效 末 ， setLights() 方 法 
接收 3 个 参数 ， 第 一 个 参数 用 于 指定 LED 灯 的 颜色 ， 第 二 个 参数 用 于 指 
定 LED 人 灯亮 起 的 时 长 ， 以 毫秒 为 单位 ， 第 三 个 参数 用 于 指定 LED 灯 暗 去 
的 时 长 ， 也 是 以 毫秒 为 单位 。 所 以 ， 当 通知 到 来 时 ， 如 果 想 要 实现 LED 
灯 以 绿色 的 灯光 一 闪 一 闪 的 效果 ， 就 可 以 写成 : 


Notification notification = new NotificationCompat.Builder(this) 








.setLights(Color .GREEN, 1000, 1000) 
build(); 


当然 ， 如 果 你 不 想 进 行 那么 多 繁杂 的 设置 ， 也 可 以 直接 使 用 通知 的 默认 
> 会 根据 当前 手机 的 环境 来 决定 播放 什么 铃声 ， 以 及 如 何 振动 ， 
写法 如 下 : 


.SetDefaults(NotificationCompat .DEFAULT_ALL) 
build(); 


注意 ， 以 上 所 涉及 的 这 些 进 阶 技巧 都 要 在 手机 上 运行 才能 看 得 到 效果 ， 
模拟 器 是 无 法 表现 出 振动 以 及 LED 和 内 烁 等 功能 的 。 


8.2.3 ”通知 的 高 级 功能 


继续 观察 NotificationCcompat .Builder 这 个 类 ， 你 会 发 现 里 面 还 有 很 多 
API 是 我 们 没有 使 用 过 的 。 那 么 下 面 我 们 就 来 学 习 一 些 更 加 强大 的 API 
的 用 法 ， 从 而 构建 出 更 加 丰富 的 通知 效果 。 


先 来 看 看 setstyle() 方 法 ， 这 个 方法 允许 我 们 构建 出 襄 文 本 的 通知 内 
容 。 也 就 是 说 通知 中 不 光 可 以 有 文字 和 图 标 ， 还 可 以 包含 更 多 的 东 
西 。 SOty le I | Mott eat onc npat style 参 数 ， 这 个 参 


数 就 是 用 来 构建 具体 的 是 文本 信息 的 ， 如 长 文学 、 图 片 等 。 


在 开始 使 用 setstyle() 方 法 之 前 ， 我 们 先 来 做 一 个 试验 吧 ， 之 前 的 通知 
内 容 都 比较 短 ， 如 果 设 置 成 很 长 的 文字 会 是 什么 效果 呢 ? 比 如 这 样 写 : 


Notification notification = new NotificationCompat.Builder(this) 

















etco nte heTex EC Learn how to build notifications, send and sync data, and use 
ctions. Ce t the 5 ial An 证 oid TDE afd develo oper tools 2 bt iad 
Ee 下 ") 


build(); 








现在 重新 运行 程序 并 触发 通知 ， 效 果 如 图 8.8 所 示 。 


This is content title 5-36 AM 
Learn how to build notifications, send and symc dat.. 





图 8.8 ”通知 内 容 文 字 过 长 的 效果 


可 以 看 到 ， 通 知 内 容 是 无 法 显示 完整 的 ， 多 余 的 部 分 会 用 省 略 号 来 代 
玲 。 其 实 这 也 很 正常 ， 因 为 通知 的 内 容 本 来 就 应 该 言 简 意 凡 ， 详 细 内 容 
放 到 点 击 后 打开 的 活动 当中 会 更 加 合适 。 


但 是 如 果 你 真 的 非常 需要 在 通知 当中 显示 一 段 长 文字 ，Android 也 是 文 
持 的 ， 通 过 setstyle() 方 法 就 可 以 做 到 ， 有 具体 写法 如 下 : 


Notification notification = new NotificationCompat .Builder(this) 




















.SetStyle(new NotificationCompat.BigTextStyle().bigText("Learn how to build 
notifications, send and sync data, and use voice actions. Get the official 
Android IDE and developer tools to build apps for Android.")) 

.build(); 


我 们 在 setstyle( ) 方 法 中 创建 了 一 人 人 NotificationCcompat .BigTextSty]e 
对 象 ， 这 个 对 象 融 是 用 于 封装 长 文字 信息 的 ， 我 们 调用 它 的 bigText () 
方法 并 将 文字 内 容 传 入 就 可 以 了 。 


再 次 重新 运行 程序 并 触发 通知 ， 效 果 如 图 8.9 所 示 。 


This is content title 6:19 AM 
Learn how to build notifications, send and sy 


data, and use voice actions. Get the official Android 


IDE and developer tools to build apps for Android 





图 8.9 通知 中 显示 长 文字 的 效果 


除了 显示 长 文字 之 外 ， 通 知 里 还 可 以 显示 一 张大 图 片 ， 具 体 用 法 也 是 基 
本 相似 的 : 


Notification notification = new NotificationCompat.Builder(this) 


.SetStyle(new NotificationCompat.BigPicturestyle().bigPicture 
(BitmapFactory.decodeResource(getResources(), R.drawable.big_ image))) 
.build(); 


可 以 看 到 ， 这 里 仍然 是 调用 的 setstyle() 方 法 ， 这 次 我 们 在 参数 中 创建 
了 一 个 Notificationcompat .BigPicturestyle 对 象 ， 这 个 对 象 就 是 用 于 
设置 大 图 片 的 ， 然 后 调用 它 的 bigpPicture() 方 法 并 将 图 片 传 入 。 这 里 我 
事先 准备 好 了 一 张 图 片 ， 通 过 BitmapFactory 的 decodeResource() 方 法 将 
图 片 解 析 成 Bitmap 对 象 ， 再 传 入 到 bigPicture() 方 法 中 就 可 以 了 。 


现在 重新 运行 一 下 程序 并 触发 通知 ， 效 果 如 图 8.10 所 示 。 








图 8.10 通知 中 显示 大 图 片 的 效果 
这 样 我 们 就 把 setstyle() 方 法 中 的 重要 内 容 基 本 都 掌握 了 。 


接 下 来 再 学 习 一 下 setPriority() 方 法 ， 它 可 以 用 于 设置 通知 的 重要 程 
度 。setPriority() 方 法 接收 一 个 上 整 型 参数 用 于 设置 这 条 通知 的 重要 程 





度 ， 一 共有 5 个 常量 值 可 选 : PRIORITY_DEFAULT 表 示 默 认 的 重要 程度 ， 和 
不 设置 效果 是 一 样 的 ，PRIORITY_MIN 表 示 最 低 的 重要 程度 ， 系 统 可 能 只 
会 在 特定 的 场景 才 显 示 这 条 通知 ， 比 如 用 户 下 拉 状 态 栏 的 时 

候 ; PRIORITY_Low 表 示 较 低 的 重要 程度 ， 系 统 可 能 会 将 这 类 通知 缩小 ， 

或 改变 其 显示 的 顺序 ， 将 其 排 在 更 重要 的 通知 之 后 ; PRIORITY_HIGH 表 

示 较 高 的 重要 程度 ， 系 统 可 能 会 将 这 类 通知 放大 ， 或 改变 其 显示 的 顺 

序 ， 将 其 排 在 比较 靠 前 的 位 置 ，PRIORITY_MAx 表 示 最 高 的 重要 程度 ， 这 
人 
写法 如 下 : 


Notification notification = new NotificationCompat.Builder(this) 




















.SetPpriority(NotificationCompat .PRIORITY_MAX) 
.build(); 





这 里 我 们 将 通知 的 重要 程度 设置 成 了 最 高 ， 表示 这 十 一 条 非常 重要 的 通 
知 ， 要 求 用 户 必 须 立 刻 看 到 。 现 在 重新 运行 一 下 程序 ， 并 点 击 Send 
notice 按 钮 ， 效 果 如 图 8.11 所 示 。 





This is content title 
本 中 content x 








图 8.11 触发 一 条 重要 通知 


可 以 看 到 ， 这 次 的 通知 不 是 在 系统 状态 栏 显示 一 个 小 图 标 了 ， 而 是 弹出 
了 一 个 横幅 ， 并 附带 了 通知 的 详细 和 内容， 表示 这 和 是 一 条 非常 重要 的 通 
知 。 不 管用 户 现在 是 在 玩 游 戏 还 是 看 电影 ， 这 条 通知 都 会 显示 在 最 上 
方 ， 以 此 引起 用 户 的 注意 。 当 然 ， 使 用 这 类 通知 时 一 定 要 小 心 ， 确 保 你 
的 通知 内 容 的 确 是 至 关 重 要 的 ， 不 然 如 果 让 用 户 产 生 反 感 的 话 ， 很 可 能 
会 导致 我 们 的 应 用 程序 被 邹 载 。 








8.3 ”调用 摄像 头 和 相册 


我 们 平时 在 使 用 QQ 或 微 信 的 时 候 经 常 要 和 别人 分 至 图 片 ， 这 些 图 片 可 
以 是 用 手机 摄像 头 担 的 ， 也 可 以 是 从 相册 中 选取 的 。 类 似 这 样 的 功能 实 
在 是 太 冲 见 了 ， 几 乎 在 每 一 个 应 用 程序 中 都 会 有 ， 那 么 本 节 我 们 就 学 习 
一 下 调用 摄像 头 和 相册 方面 的 知识 。 


8.3.1 调用 摄像 头 拍照 


先 来 看 看 摄像 头 方面 的 知识 ， 现 在 很 多 的 应 用 都 会 要 求 用 户 上 传 一 张 图 
片 来 作为 头像 ， 这 时 打开 摄像 头 拍 张 照 是 最 简单 快捷 的 。 下 面 就 让 我 们 
如 何 才 能 在 应 用 程序 里 调用 手机 的 摄像 头 进 
行 担 照 。 


新 建 一 个 CameraAlbumTest 项 目 ， 然 后 修改 activity_main.xml 中 的 代码 ， 
如 下 所 示 : 








L arLayout A Qa 01 id= "http: //schemas.android.com/apk/res/android" 
ndroid:orienta ati 
Natoid 1 ave width= Mas h oparent' 
droid:layout_hei a atch_parent" > 
Button 
android:id="@+id/take_photo 
android:1layou vt wdthrmatch eh 
android:1layou ut_hei ight=" "Wrap_ content" 
android:text="Take Photo" /> 
ImageView 
android:id="@+id/pict 三 
android:layout_width ap_ tent 
ndroid:layout_height="wrap_content 
android:layout_gravity="cen _hor Ea 
/Lin Layout> 


可 以 看 到 ， 布 局 文件 中 只 有 两 个 控件 ， 一 个 Button 和 一 个 ImageView。 
人 的 ， 而 ImageView 则 是 用 于 将 拍 到 的 
显示 出 来 。 


然后 开始 编写 调用 摄像 头 的 具体 逻辑 ， 修 改 MainActivity 中 的 代码 ， 如 
下 所 示 : 


public static final int TAKE_PHOTO = 1; 


private ImageView picture; 


private Uri imageUri; 


@Ooverride 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceSstate); 
setContentView(R.1layout.activity main); 
Button takePhoto = (Button) findViewById(R.id. Ee _photo); 
picture = (ImageView) findViewById(R.id.pictur 
takePhoto.setOonClickListener (new View. ONCTICkIA tCEnert) { 
@override 
public void onClick(View v) { 
// 创建 File 对 象 ， 用 于 存储 拍照 后 的 图 片 
File outputImage = new File(getExternalCacheDir()， 
"output_image.jpg") 

















try { 
if (outputImage.exists()) { 
outputImage.delete(); 


outputImage.createNewFile(); 
} catch (IOException e) { 
e.printStackTrace(); 


} 
if (Build.VERSION.SDK_INT >= 24) 
imageuri = = FileProvider .getUriForFile(MainActivity.this 
"com.example.cameraalbumtest.fileprovider", outputImage); 
} else { 
imageUri = Uri.fromFile(outputImage); 


} 
// 启动 相机 程序 
Intent intent = new Intent("android.media.action.IMAGE_ CAPTURE"); 
intent .putExtra(MediaStore.EXTRA_OUTPUT， imageUri); 
startActivityForResult(intent, TAKE_PHOTO); 
} 
}); 
} 


@override 
protected void onActivityResult(int requestCode, int resultCode, Intent data) { 
switch (requestCode) { 
case TAKE_PHOTO: 
if (resultCode == RESULT_OK) { 
try 工 
// 将 拍摄 的 照片 显示 出 来 
Bitmap bitmap = BitmapFactory. decodeStream(getContent - 
Resolver() .openInputStream(imageUri) )， 
picture.setImageBitmap(bitmap ) 
} catch (FileNotFoundException e) { 
e.printStackTrace(); 


} 


} 

break; 
default: 

break; 


上 上述 代码 稍微 有 束 复 休 ， 我 们 来 仔细 地 分 析 一 下 。 在 MainActivity 中 要 

做 的 第 一 件 事 自然 是 分 别 获取 到 Button 和 ImageView 的 实例 ， 并 给 Button 
注册 上 点 击 事 件 ， 然 后 在 Button 的 点 击 事件 里 开始 处 理 调 用 摄像 头 的 逻 
辑 ， 我 们 重点 看 一 下 这 部 分 代码 。 


首先 这 里 创建 了 一 个 File 对 象 ， 用 于 存放 摄像 头 拍 下 的 图 片 ， 这 里 我 们 
把 图 片 命名 为 output_image.jpg， 并 将 它 存 放 在 手机 SD 卡 的 应 用 关联 绥 
存 目录 下 。 什 么 叫 作 应 用 关联 缓存 目录 呢 ? 就 是 指 SD 卡 中 专门 用 于 存 
放 当 前 应 用 缓存 数据 的 位 置 ， 调 用 getExternalcacheDir() 方 法 可 以 得 到 
这 个 目录 ， 有 具体 的 路 径 是 /sdcard/Android/data/<package name>/cache。 那 
么 为 化 么 要 使 用 应 用 关联 绥 目录 来 存放 图 片 呢 ? 因为 从 Android 6.0 系 统 
开始 ， 读 写 SD 卡 被 列 为 了 危险 权限 ， 如 果 将 图 片 存放 在 SD 卡 的 任何 其 
他 目 录 ， 都 要 进行 运行 时 权限 处 理 才 行 ， 而 使 用 应 用 关联 目录 则 可 以 跳 














过 这 一 步 。 


接着 会 进行 一 个 判断 ， 如 果 运 行 设备 的 系统 版 本 低 于 Android 7.0， 就 调 
用 Uri 的 fromFile() 方 法 将 File 对 象 转换 成 uri 对象， 这 个 Uri 对 象 标识 着 
output_image.jpg 这 张 图片 的 本 地 真实 路 笃 。 奋 则 ， 就 调用 FileProvider 的 
getUriForFile() 方 法 将 File 对 象 转换 成 一 个 封装 过 的 Uri 对 

sh geturiForFile() 方 法 接收 3 个 参数 ， 第 一 个 参数 要 求 传 入 context 对 
象 ， 第 二 个 参数 可 以 是 任意 唯一 的 字符 串 ， 第 三 个 参数 则 是 我 们 刚刚 创 
建 的 File 对 象 。 之 所 以 要 进行 这 样 一 层 转 换 ， 是 因为 从 Android 7.0 系 统 
开始 ， 直 接 使 用 本 地 真实 路 径 的 Uri 被 认为 是 不 安全 的 ， 会 抛 出 一 个 
FileUriExposedException 异 常 。 而 FileProvider 则 是 一 种 特殊 的 内 容 提 供 
器 ， 它 使 用 了 和 内 容 提供 器 类 似 的 机 制 来 对 数据 进行 保护 ， 可 以 选择 性 
地 将 封装 过 的 Uri 共 享 给 外 部 ， 从 而 提高 了 应 用 的 安全 性 。 


接 下 来 构建 出 了 一 个 Intent 对 象 ， 并 将 这 个 Intent 的 action 指 定 

为 android.media,action,.IMAGE_CAPTURE， 上 再 调用 Intent 的 putExtra() 方 
法 指定 图 乒 的 输出 地 址 ， 这 里 填 入 刚刚 得 到 的 Uri 对 象 ， 最 后 调 

用 startActivityForResult() 来 启动 活动 。 由 于 我 们 使 用 的 是 一 个 隐 式 
Intent， 系 统 会 找 出 能 够 啊 应 这 个 Intent 的 活动 去 启动 ， 这 样 照 相机 程序 
就 会 被 打开 ， 折 下 的 照片 将 会 输出 到 output_image.jpg 中 。 


注意 ， 刚 才 我 们 是 使 用 startActivityForResult( ) 来 启动 活动 的 ， 因 此 
担 完 照 后 会 有 结 采 返回 到 onActivityResult() 方 法 中 。 如 果 发 现 担 照 成 
功 ， 束 可 以 调用 BitmapFactory 的 decodestream( 7 oupute mae 
这 张 照片 解析 成 Bitmap 对 象 ， 然 后 把 它 设置 到 ImageView 中 显示 出 来 。 


不 过 现在 还 没 结束 ， 刚 才 提 到 了 内 容 提 供 器 ， 那 么 我 们 上 自然 要 在 
AndroidManifest.xml 中 对 内 容 提 供 器 进行 注册 了 ， 如 下 所 示 : 


<manifest mS a rot tb/ enas on oes om/aps es/anok od 
package="com.example. aalbumtest"> 


ek a upp rt.v4. nie be FileProvider" 
ample. aalbumte st i 1e eprovider" 


ce 
到 
吕 
多。 


an 


="a oid.support. FILE. PROVIDER_PATHS" 
ee miZf le_paths" /> 


其 中 ，android:name 属 性 的 值 是 固定 的 ，android:authorities 属 性 的 值 
必须 要 和 刚才 Fileprovider.getUuriForFile() 方 法 中 的 第 二 个 参数 一 
致 。 另 外 ， 这 里 还 在 <provider> 标 签 的 内 部 使 用 <meta-data> 来 指定 uri 
的 共 孕 路径， 并 引用 了 一 个 @xml/file_paths 资 源 。 当 然 ， 这 个 资源 现在 
还 是 不 存在 的 ， 下 面 我 们 就 来 创建 它 。 


右 击 res 目 录 -New 一 Directory， 创 建 一 个 xml 目 录 ， 接 着 右 击 xml 目 录 
,New File， 创 建 一 个 们 e_paths.xml 文 件 。 然 后 修改 科 e_paths.xml 文 件 
中 的 内 容 ， 如 下 所 示 : 








? ion="1.0" encoding="utf-8"?> 
<paths xmlns:android="http://schemas.android.com/apk/res/android"> 
<external-path name="my_images" path="" /> 

> 





其 中 ，external-path 就 是 用 来 指定 uri 共 享 的 ，name 属 性 的 值 可 以 随便 
填 ，path 属 性 的 值 表示 共享 的 具体 路 径 。 这 里 设置 空 值 就 表示 将 整个 SD 
了 当然 你 也 可 以 仅 共 享 我 们 存放 output_image.jpg 这 张 图 片 的 
路 径 。 


另外 还 有 一 点 要 注意 ， 在 Android 4.4 系 统 之 前 ， 访 问 SD 卡 的 应 用 关联 目 

录 也 是 要 声明 权限 的 ， 从 4.4 系 统 开 始 不 再 需要 权限 声明 。 那 么 我 们 为 

了 能 够 兼容 老 版 本 系统 的 手机 ， 还 需要 在 AndroidManifest.xzml 中 声明 一 
下 访问 SD 卡 的 权限 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.ca 1 S 
<uses-permission android:name="android.permission.WRITE_ EXTERNAL_STORAGE" /> 




















</manifest> 


这 样 代码 就 都 编写 完了 ， 现 在 将 程序 运行 到 手机 上 ， 然 后 点 击 Take 
Photo 按 钮 就 可 以 进行 拍照 了 ， 如 图 8.12 所 示 。 拍 照 完 成 后 ， 点 击 中 间 按 
钮 束 会 回 到 我 们 程序 的 界面 。 同时， 拍摄 的 照片 也 会 显示 出 来 了 了 ， 如 图 
8.13 所 示 。 





图 8.12 ”打开 摄像 头 拍 照 


Me ey 
CameraAlbumTest 


TAKE PHOTO 





图 8.13 拍照 的 最 终 效 果 
8.3.2 ”从 相册 中 选择 照片 


里 然 调 用 摄像 头 拍 照 既 方 便 双 快捷， 但 我 们 并 不 是 每 次 都 需要 去 当场 拍 
一 张 照片 的 。 因 为 每 个 人 的 手机 相册 里 应 该 都 会 在 有 许 许多 多 张 照片 ， 
直接 从 相册 里 选取 一 张 现 有 的 照片 会 比 打开 相机 拍 一 张 照片 更 加 第 用 。 
一 个 优秀 的 应 用 程序 应 该 将 这 两 种 选择 方式 都 提供 给 用 户 ， 由 用 户 来 决 
0 
I 功能 。 


还 是 在 CameraAlbumTest 项 目的 基础 上 进行 修改 ， 编 辑 activity_main.xml 





文件 ， 在 布局 中 添加 一 个 按钮 用 于 从 相册 中 选择 照片 ， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<Button 
android:id="@+id/take_photo" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Take Photo" /> 


<Button 
android:id="@+id/choose_from_album" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Choose From Album" /> 


<ImageView 
android:id="@+id/picture" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center_horizontal" /> 





</LinearLayout> 


然后 修改 MainActivity 中 的 代码 ， 加 入 从 相册 选择 照片 的 逻辑 ， 代 码 如 
下 所 示 : 


public class MainActivity extends AppCompatActivity { 


public static final int CHOOSE PHOTO = 2; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity_main); 
Button takePhoto = (Button) findvViewById(R.id.take photo); 
Button chooseFromAlbum = (Button) findViewById(R.id.choose from album); 


chooseFromAlbum.setOnClickListener(new View.0nClickListener() { 
@Override 
public void onClick(View v) { 
if (ContextCompat .checkSelfPermission(MainActivity.this， 
Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager. 
PERMISSION_GRANTED) { 
ActivityCompat.requestPermissions(MainActivity.this, new 
String[]{ Manifest.permission. WRITE_EXTERNAL_STORAGE }, 1); 
} else { 
openAlbum( ) ; 
} 


}); 
} 


private void openAlbum() { 
Intent intent = new Intent("android.intent.action.GET_CONTENT"); 
intent.setType("image/*"); 
startActivityForResult(intent, CHOOSE_PHOT0); // 打开 相册 

} 


@Override 
public void onRequestPermissionsResult(int requestCode, String[] permissions, 
int[] grantResults) { 
switch (requestCode) { 
Cas: 
if (grantResults.length > 0 && grantResults[0] == PackageManager. 
PERMISSION_GRANTED) { 
openAlbum( ) ; 
} else { 
Toast.makeText(this, "You denied the permission", 
Toast .LENGTH_SHORT). show( ); 


break; 
default: 
} 
} 
@Override 


protected void onActivityResult(int requestCode, int resultCode, Intent data) { 
switch (requestCode) { 


case CHOOSE_PHOTO: 
if (resultCode == RESULT_OK) { 

// 判断 手机 系统 版 本 号 

if (Build.VERSION.SDK_INT >= 19) { 
// 4.4 及 以 上 系统 使 用 这 个 方法 处 理 图 片 
handleImageOnKitKat(data) ; 

} else { 
// 4.4 以 下 系统 使 用 这 个 方法 处 理 图 片 
handleImageBeforeKitkat (data); 





























} 
} 
break; 
default: 
break; 
} 
} 
@TargetApi(19) 


private void handleImageOonKitkKat(Intent data) { 
String imagePath = null; 
Uri uri = data.getData(); 
if (DocumentsContract.isDocumentUri(this, uri)) { 
// 如 果 是 document 类 型 的 Uri， 则 通过 document id 处 理 
String docId = DocumentsContract.getDocumentId(uri); 
if("com.android.providers.media.documents".equals(uri.getAuthority())) { 
String id = docId.split(":")[1]; // 解析 出 数字 格式 的 id 
String selection = MediaStore.Images.Media._ID + "=" + id; 
imagePath = getImagePath(MediaStore.Images.Media.EXTERNAL_ 
CONTENT_URI, selection); 
} else if ("com.android.providers.downloads.documents".equals(uri. 
getAuthority())) { 
Uri contentUri = ContentUris.withAppendedId(Uri.parse("content: 
//downloads/public_ downloads"), Long.valueof(docId)); 
imagePath = getImagePath(contentUri, null); 








} else if ("content".equalsIgnoreCase(uri.getSscheme())) { 
// 如 果 是 content 类 型 的 Uri， 则 使 用 普通 方式 处 理 
imagePath = getImagePath(uri, null); 
} else if ("file".equalsIgnoreCase(uri.getscheme())) { 
// 如 果 是 file 类 型 的 Uri， 直 接 获 取 图 片 路 径 即 可 
imagePath = uri.getPath(); 

















} 
displayImage(imagePath); // 根据 图 片 路 径 显 示 图 片 
} 


private void handleImageBeforeKitkat(Intent data) { 
Uri uri = data.getData(); 
String imagePath = getIimagePath(uri, null); 
displayImage(imagePath); 

} 


private String getImagePath(Uri uri, String selection) { 

String path = null; 
// 通过 Uri 和 selection 来 获取 真实 的 图 片 路 径 
Cursor cursor = getContentResolver().query(uri, null, selection, null, null); 
if (cursor != null) { 

if (cursor.moveToFirst()) { 

path = cursor.getString(cursor.getColumnIndex(MediaStore. 
Images.Media.DATA)); 


cursor.close(); 


} 


return path; 


} 


private void displayImage(String imagePath) { 
if (imagePath != null) { 
Bitmap bitmap = BitmapFactory.decodeFile(imagePath ) ， 
picture.setImageBitmap(bitmap); 
} else { 
Toast.makeText(this, "failed to get image", Toast.LENGTH_SHORT).show(); 
} 


可 以 看 到 ， 在 Choose From Album 按 钮 的 点 击 事件 里 我 们 先是 进行 了 一 
个 运行 时 权限 处 理 ， 动 态 申 请 wRITE_EXTERNAL_STORAGE 这 个 危险 权限 。 
为 什么 需要 申请 这 个 权限 昵 ? 因 为 相册 中 的 照片 都 是 存储 在 SD 卡 上 

的 ， 我 们 要 从 SD 卡 中 读 取 照片 束 需 要 申请 这 个 权 

限 。wRITE_EXTERNAL_STORAGE 表 示 同 时 授予 程序 对 SD 卡 读 和 写 的 能 力 。 








当 用 户 授权 了 权限 申请 之 后 会 调用 openAlbum( ) 方 法 ， 这 里 我 们 先是 构 
建 出 了 一 个 Intent 对 象 ， 并 将 它 的 action 指 定 

为 android.intent.action.GET_CONTENT。 接着 给 这 个 Intent 对 象 设置 一 
些 必 要 的 参数 ， 然 后 调用 startActivityForResult() 方 法 就 可 以 打开 相 
册 程 序 选 择 照片 了 。 注 意 在 调用 startActivityForResult() 方 法 的 时 
候 ， 我 们 给 第 二 个 参数 传 入 的 值 变 成 了 chHoosE_PHoT0， 这 样 当 从 相册 选 
择 完 图 片 回 到 onActivityResult() 方 法 时 ， 就 会 进入 cHoosE_PHoTo 的 
case 来 处 理 图 片 。 接 下 来 的 逻辑 就 比较 复杂 了 ， 首 先 为 了 兼容 新 老 版 本 
的 手机 ， 我 们 做 了 一 个 判断 ， 如 果 是 4.4 及 以 上 系统 的 手机 就 调 

用 handleImageonKitkat() 方 法 来 处 理 图 片 ， 否 则 就 调 

用 handleImageBeforeKitKat() 方 法 来 处 理 图 片 。 之 所 以 要 这 样 做 ， 是 因 
为 Android 系 统 从 4.4 版 本 开始 ， 选 取 相 册 中 的 图 片 不 再 返回 图 片 真实 的 
Uri 了 ， 而 是 一 个 封装 过 的 Uri， 因 此 如 果 是 4.4 版 本 以 上 的 手机 就 需要 对 
这 个 Uri 进 行 解析 才 行 。 


那么 handleImageonKitkat() 方 法 中 的 逻辑 就 基本 是 如 何 解 析 这 个 封装 过 
的 Uni 了。 这 里 有 好 几 种 判断 情况 ， 如 果 返 回 的 Uri 是 document 类 型 的 

话 ， 那 就 取出 document ”id 进 行 处 理 ， 如 果 不 是 的 话 ， 那 就 使 用 普通 的 
方式 处 理 。 男 外 ， 如 果 Uri 的 authority 是 media 格 式 的 话 ，document ”id 还 
需要 再 进行 一 次 解析 ， 要 通过 字符 串 分 割 的 方式 取出 后 半 部 分 才能 得 到 
真正 的 数字 id。 取 出 的 id 用 于 构建 新 的 Uri 和 条 件 语句 ， 然 后 把 这 些 值 作 
为 参数 传 入 到 getImagePath() 方 法 当中 ， 束 可 以 获取 到 图 片 的 真实 路 径 
人 再 调用 displayImage() 方 法 将 图 片 显 示 到 界 





相 比 于 handleImageonKitKat( ) 去 ; handleImageBeforeKitKat( ) 方 法 中 
的 逻辑 就 要 简单 得 多 了 ， 因 为 它 的 Uri 是 没有 封装 过 的 ， 不 需要 任何 解 
析 ， 直 接 将 Uri 传 入 到 getImagePath() 方 法 当中 就 能 获取 到 图 片 的 真实 路 
径 了 ， 最 后 同样 是 调用 displayImage() 方 法 来 让 图 片 显示 a 到 界面 上 。 


现在 将 程序 重新 运行 到 手机 上 ， 然 后 点 击 一 下 Choose ”From ”Album 按 
钮 ， 首 先 会 弹出 权限 申请 枉 ， 如 图 8.14 所 示 。 





而 23:38 


区 到 要 允许 


CameraAlbumTest 方 上 
您 设备 上 的 照片 、 媒 体 
内 容 和 文件 吗 ? 


拒绝 





图 8.14 申请 访问 SD 卡 权限 
扩 击 允许 之 后 就 会 打开 手机 相册 ， 如 图 8.15 所 示 。 








图 8.15 打开 手机 相册 


然后 随意 选择 一 张 照片 ， 回 到 我 们 程序 的 界面 ， 选 中 的 照片 应 该 就 会 显 
示 出 来 了 ， 如 图 8.16 所 示 。 


pp | 夯 23:51 
CameraAlbumTest 


TAKE PHOTO 


CHOOSE FROM ALBUM 





图 8.16 ”选择 照片 的 最 终 效 果 


调用 摄像 头 担 照 以 及 从 相册 中 选择 照片 是 很 多 Android 应 用 都 会 带 有 的 
功能 ， 现 在 你 已 经 将 这 两 种 技术 都 学 会 了 ， 将 来 在 工作 中 如 果 需 要 开 友 
类 似 的 功能 ， 相 信 你 一 定 能 轻松 完成 的 。 不 过 目前 我 们 的 实现 还 不 算 完 
美 ， 因 为 人 条 些 照片 即使 经 过 裁 王 后 体积 仍然 很 大 ， 直 接 加 载 到 内 存 中 有 
可 能 会 导致 程序 骨 沉 。 更 好 的 做 法 是 根据 项 目的 需求 先 对 照片 进行 适当 
的 压缩 ， 然 后 再 加 载 到 内 存 中 。 人 至 于 如 何 对 照 户 进行 压缩 ， 就 要 考验 你 
查阅 资料 的 能 力 了 ， 这 里 就 不 再 展开 进行 讲解 了 。 


8.4 播放 多 尹 体 文件 


手机 上 最 种 见 的 休闲 方式 坚 无 疑问 台 是 听 音 乐 和 看 电影 了 ， 随 着 移动 设 
备 的 普及 ， 越 来 越 多 的 人 都 可 以 随时 享受 优美 的 音乐 ， 以 及 观看 精彩 的 
电影 。 而 Android 在 播放 音频 和 视频 方面 也 是 做 了 相当 不 错 的 支持 ， 它 
提供 了 一 套 较 为 完整 的 API， 使 得 开发 者 可 以 很 轻松 地 编写 出 一 个 简易 
的 音频 或 视频 播放 器 ， 下 面 我 们 就 来 具体 地 学 习 一 下 。 


8.4.1 播放 音频 


在 Android 中 播放 音频 文件 一 般 都 是 使 用 MediapPlayer 类 来 实现 的 ， 它 对 
多 种 格式 的 音频 文件 提供 了 非常 全 面 的 控制 方法 ， 从 而 使 得 播放 音乐 的 
工作 变 得 十 分 简单 。 下 表 列 出 了 Mediaplayer 类 中 一 些 较为 常用 的 控制 
7 

















设置 要 播放 的 首 频 文件 的 位 置 
ee 前 调用 这 个 方法 完成 准备 工作 
| | 开始 或 继续 播放 音频 

| | 暂停 播放 首 频 

| | 将 MediaPlayer 对 象 重 置 到 刚刚 创建 的 状态 




















| 从 指定 的 位 置 开始 播放 音频 

| | 停止 播放 音频 。 调 用 这 个 方法 后 的 MediaPlayer 对 象 无 法 再 播放 音频 
| 释放 掉 与 MediaPlayer 对 象 相关 的 资源 

| | 判断 当前 MediaPlayer 是 否 正在 播放 音频 

















简单 了 解 了 上 述 方法 后 ， 我 们 再 来 梳理 一 下 MediapPlayer 的 工作 流程 。 
首先 需要 创建 出 一 个 MediaPlayer 对 象 ， 然 后 调用 setDatasource() 方 法 
来 设置 音频 文件 的 路 径 ， 再 调用 prepare() 方 法 使 ediaplayer 进 入 到 准 
备 状态 ， 接 下 来 调用 start() 方 法 就 可 以 开始 播放 音频 ， 调 用 pause() 方 
法 就 会 暂停 播放 ， 调 用 reset() 方 法 就 会 停止 播放 。 


下 面 就 ns 体 的 例子 来 学 习 一 下 吧 ， 新 建 一 个 
PlayAudioTest 项 目 ， 然 后 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<Button 
android:id="@+id/play" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Play" /> 


<Button 
android:id="@+id/pause" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Pause" /> 


<Button 
android:id="@+id/stop" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Stop" /> 


</LinearLayout> 


i 分 别 用 于 对 音频 文件 进行 播放 、 和 暂停 和 停 
止 操作 。 然 后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener{ 
private MediaPlayer mediaPlayer = new Mediaplayer(); 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedIinstanceState); 
setContentView(R.1layout.activity main); 
Button play = (Button) findViewById(R.id.play); 
Button pause = (Button) findViewById(R.id.pause); 
Button stop = (Button) findViewById(R.id.stop); 
play.setonclickListener(this); 
pause.setonClickListener(this); 
stop.setonclickListener(this); 
if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest. permission. 
WRITE_EXTERNAL_STORAGE) != PackageManager .PERMISSION_GRANTED) { 
ActivityCompat.requestPermissions(MainActivity.this, new String[]{ 
Manifest.permission. WRITE_ EXTERNAL_ STORAGE }, 1); 
} else { 
initMediaPlayer(); // 初始 化 MediaPlayer 


} 
} 
private void initMediaPlayer() { 
try { 
File file = new File(Environment .getExternalStorageDirectory()， 
"music .mp3") 
mediaPlayer.setDataSource(file.getPath()); // 指定 音频 文件 的 路 径 
mediaPlayer.prepare(); // 让 MediaPlayer 进 入 到 准备 状态 
} catch (Exception e) { 
e.printSstackTrace(); 
} 
} 
@override 


public void onRequestPermissionsResult(int requestCode, String[] permissions, 


int[] grantResults) { 
switch (noesrcode) 
case 1: 

本 (grantResults.length > 9 && grantResults[0] == PackageManager. 
PERMISSION_GRANTED) { 
initMediaplayer(); 

} else { 

Toast .makeText(this, "拒绝 权限 将 无 法 使 用 程序 "， 
Toast .LENGTH_SHORT). show( ); 
finish(); 














break; 
default: 


} 


@override 
public void onClick(View v) { 
switch (v.getId()) 
case R.id.play: 
if (!mediaPlayer.isPlaying()) { 
mediaPlayer.start(); // 开始 播放 


} 
break 
case R.id.pause: 
if (mediaPlayer.isPlaying()) { 
mediaPlayer.pause(); // 暂停 播放 


case R.id' stop: 
if (mediaPlayer.isPlaying()) { 
mediaPlayer.reset(); // 停止 播放 





initMediaplayer(); 
break; 
default: 
break; 
} 
} 
@override 


protected void onDestroy() { 
super .onDestroy(); 
if (mediaPlayer != null) { 
mediaplayer.stop(); 
mediaplayer .release(); 
} 
} 


可 以 看 到 ， 在 类 初始 化 的 时 候 我 们 就 完 创 建 了 一 个 MediaPlayer 的 实例 ， 
然后 在 oncreate( ) 方 法 中 进行 了 运行 时 权限 处 理 ， 动 态 申 请 
WRITE_EXTERNAL_STORAGE 权 限 。 这 是 由 于 竺 会 我 们 会 在 SD 卡 中 放置 一 个 
音频 文件 ， 程 序 为 了 播放 这 个 音频 文件 必须 拥有 访问 SD 卡 的 权限 才 

行 。 注 意 ， Sd es Ua ti 如 果 用 户 拒 绝 了 
权限 申请 ， 那 么 就 调用 finish() 方 法 将 程序 直接 关 掉 ， 因 为 如 果 没 有 SD 
卡 的 访问 权限 ， 我 们 这 个 程序 将 什么 都 干 不 了 。 


用 户 同 意 授 权 之 后 就 会 调用 initMediaplayer() 方 法 为 Mediaplayer 对 象 
进行 初始 化 操作 。 在 initMediaPlayer() 方 法 中 ， 首 先是 通过 创建 一 
个 File 对 象 来 指定 音频 文件 的 路 径 ， 从 这 里 可 以 看 出 ， 我 们 需要 事先 在 
SD 卡 的 根 目 录 下 放置 一 个 名 为 music.mp3 的 音频 文件 。 后 面 依次 调用 了 
setDatasource() 方 法 和 prepare() 方 法 ， 为 MediaPlayer 做 好 了 播放 前 的 
准备。 


接 下 来 我 们 看 一 下 各 个 按钮 的 点 击 事件 中 的 代码 。 当 点 击 Play 按钮 时 会 

















进行 判断 ， 如 果 当 前 MediaPlayer 没 有 正在 播放 音频 ， 则 调用 start() 方 
法 开始 播放 。 当 点 击 Pause 按 钮 时 会 判断 ， 如 果 当 前 MediaPlayer 下 在 播 
放 音 频 ， 则 调用 pause() 方 法 暂停 播放 。 当 点 击 Stop 按 钮 时 会 判断 ， 如 果 
当前 MediaPlayer 正 在 播放 音频 ， 则 调用 reset () 方 法 将 MediaPlayer 重 置 
为 刚刚 创建 的 状态 ， 然 后 重新 调用 一 过 initMediapPlayer() 方 法 。 


最 后 在 onpestroy() 方 法 中 ， 我 们 还 需要 分 别 调 用 stop() 方 法 和 
release() 方 法 ， 将 与 MediaPlayer 相 关 的 资源 释放 掉 。 


另外， 和 干 万 不 要 忘记 在 AndroidManifest.xml 文 件 中 声明 用 到 的 权限 ， 如 
下 所 示 : 


<manifest xmlns:android="http://schemas.a 
package="com.example.playaudiotest"> 
<uses-permission android:name="androi 


ndroid.com/apk/res/android" 
e="al 


d.permission.WRITE EXTERNAL_STORAGE" /> 


</manifest> 


这 样 一 个 简易 版 的 首 乐 播放 器 束 完 成 了 ， 现 在 将 程序 运行 到 手机 上 会 完 
弹出 权限 申请 框 ， 如 图 8.17 所 示 。 


py Ol A 


卫 要 人 允许 PlayAudioTest 访 
问 您 设备 上 的 照片 、 媒 
体内 容 和 文件 吗 ? 


拒绝 





图 8.17 首 乐 播放 器 主 界 面 


同意 授权 之 后 就 可 以 开始 播放 音乐 了 ， 点 击 一 下 Play 按钮 ， 优 类 的 音乐 
就 会 响起 ， 然 后 点 击 Pause 按 钮 ， 音 乐 就 会 停 住 ， 再 次 点 击 Play 按钮 ， 会 
接着 暂停 之 前 的 位 置 继续 播放 。 这 时 如 果 点 击 一 下 Stop 按 钮 ， 音 乐 也 会 
停 住 ， 但 是 当 再 次 点 击 Play 按钮 时 ， 音 乐 就 会 从 头 开始 播放 了 。 


8.4.2 ”播放 视频 
播放 视频 文件 其 实 并 不 比 播放 音频 文件 复杂 ， 主 要 是 使 用 VideoView 类 


来 实现 的 。 这 个 类 将 视频 的 显示 和 控制 集 于 一 身 ， 使 得 我 们 仅仅 借助 它 
就 可 以 完成 一 个 简易 的 视频 播放 器 。VideoView 的 用 法 和 MediaPlayer 也 





比较 类 似 ， 主 要 有 以 下 常用 方法 : 


setVideoPath( ) 有 镍 设置 要 播放 的 视频 文件 的 位 置 


start() 开始 或 继续 播放 视频 


属国 全 
| | 定 的 位 置 开始 播放 视频 
ee 判断 当 前 是 否 正 在 播放 视频 





getDuration() 用 获取 载 入 的 视频 文件 的 时 长 





那么 我 们 还 是 通过 一 个 实际 的 例子 来 学 习 一 下 吧 ， 新 建 PlayVideoTest 项 
目 ， 然 后 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<LinearLayout 
android:layout_width="match_parent" 
android:layout_height="wrap_content" > 


<Button 
android:id="@+id/play" 
android:layout_width="Qdp" 
android:layout_height="wrap_content" 
android:layout_ weight="1" 
android:text="Play" /> 


<Button 
android:id="@+id/pause" 
android:layout_width="Qdp" 
android:layout_height="wrap_content" 
android:layout weight="1" 
android:text="Pause" /> 


<Button 
android:id="@+id/replay" 
android:layout_width="Qdp" 
android:layout_height="wrap_content" 
android:layout weight="1" 
android:text="Replay" /> 





</LinearLayout> 


<VideoView 
android:id="@+id/video_view" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" /> 


</LinearLayout> 





在 这 个 布局 文件 中 ， 首 先 放置 了 3 个 按钮 ， 分 别 用 于 控制 视频 的 播放 、 
暂 集 和 重新 播放 。 然 后 在 按钮 下 面 义 放置 了 一 个 VideoView， 稍 后 的 视 
频 就 将 在 这 里 显示 。 


接 下 来 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener{ 





private VideoView videoView; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity_main); 
videoView = (VideoView) findViewById(R.id.video_ view); 
Button play = (Button) findViewById(R.id.play); 
Button pause = (Button) findViewById(R.id.pause); 
Button replay = (Button) findViewById(R.id.replay); 
play.setonclickListener(this); 
pause.setOonClickListener(this); 
replay.setonclickListener(this); 
if (ContextCompat .checkSelfPermission(MainActivity.this，Manifest . 
permission.WRITE_EXTERNAL_STORAGE) != PackageManager .PERMISSION_GRANTED) { 
ActivityCompat.requestPermissions(MainActivity.this, new String[]{ 
Manifest.permission. WRITE_ EXTERNAL_ STORAGE }, 1); 
} else { 
initVideoPath(); // 初始 化 VideoView 
} 


} 


private void initVideopath() { 
File file = new File(Environment.getExternalStorageDirectory(), "movie.mp4"); 
videoView.setVideopath(file.getPath()); // 指定 视频 文件 的 路 径 

} 


@Override 

public void onRequestPermissionsResult(int requestCode, String[] permissions, 
int[] grantResults) { 
switch (requestCode) { 

Case 
if (grantResults.length > 0 && grantResults[0] == PackageManager. 
PERMISSION_GRANTED) { 
initVideoPath(); 

















} else { 
Toast .makeText(this, "拒绝 权限 将 无 法 使 用 程序 "，Toast .LENGTH_SHORT ) . 
show( ); 
finish(); 
break; 
default: 
} 
} 
@Override 


public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.play: 
if (!videoView.isPlaying()) { 
videoView.start(); // 开始 播放 
} 


break; 
case R.id.pause: 
if (videoView.isPplaying()) { 
videoView.pause(); // 暂停 播放 
} 


break; 
case R.id.replay: 
if (videoView.isPplaying()) { 
videoView.resume(); // 重新 播放 
} 


break; 





} 


@override 
protected void onDestroy() { 
super .onDestroy(); 
if (videoView != null) { 
videoView.suspend(); 
} 


这 部 分 代码 相信 你 理解 起 来 会 很 轻松 ， 因 为 它 和 前 面 播放 音频 的 代码 非 
党 类似 。 首 先 在 oncreate() 方 法 中 同样 进行 了 一 个 运行 时 权限 处 理 ， 
为 视频 文件 将 会 放 在 SD 卡 上 。 当 用 户 同 意 授 权 了 之 后 就 会 调 

用 initvideoPath() 方 法 来 设置 视频 文件 的 路 径 ， 这 里 我 们 需要 事先 在 
SD 卡 的 根 目录 下 放置 一 个 名 为 movie.mp4 的 视频 文件 。 


下 面 看 一 下 各 个 按钮 的 点 击 事件 中 的 代码 。 当 点 击 Play 按 钮 时 会 进行 判 
断 ， 如 果 当 前 并 没有 正在 播放 视频 ， 则 调用 start() 方 法 开始 播放 。 当 
点 击 Pause 按 钮 时 会 判断 ， 如 果 当 前 视频 正在 播放 ， 则 调用 pause() 方 法 
暂停 播放 。 当 点 击 Replay 按 钮 时 会 判断 ， 如 果 当 前 视频 正在 播放 ， 则 调 
用 resume() 方 法 从 头 播放 视频 。 


最 后 在 onpestroy() 方 法 中 ， 我 们 还 需要 调用 一 下 suspend() 方 法 ， 将 
VideoView 所 占用 的 资源 释放 掉 。 


另外 ， 仍 然 始终 要 记得 在 AndroidManifest.xml 文 件 中 声明 用 到 的 权限 ， 
如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.playvideotest"> 
<uses -permission android:name="android.permission.WRITE_ EXTERNAL_STORAGE" /> 





</manifest> 





现在 将 程序 运行 到 手机 上 ， 会 先 弹出 一 个 权限 申请 对 话 框 ， 同 意 授 权 之 
后 反击 一 下 Play 控 钮 ， 束 可 以 看 到 视频 已 经 开始 播放 了 ， 如 图 8.18 所 
人 钞 。 


PlayVideoTest 





PLAY PAUSE REPLAY 





图 8.18 ”VideoView 播 放 视 频 的 效果 
点 击 Pause 按 钮 可 以 暂停 视频 的 播放 ， 点 击 Replay 按 钮 可 以 从 头 播 放 视 


这 样 的 话 ， 你 就 已 经 将 VideoView 的 基本 用 法 掌握 得 差不多 了 。 不 过 ， 

为 什么 它 的 用 法 和 MediaPlayer 这 么 相似 呢 ? 其 实 VideoView 只 是 帮 有 我 们 
做 了 一 个 很 好 的 封装 而 已 ， 它 的 背后 仍然 是 使 用 MediaPlayer 来 对 视频 文 
件 进行 控制 的 。 另 外 需要 注意 ，VideoView 并 不 是 一 个 万 能 的 视频 播放 
工具 类 ， 它 在 视频 格式 的 支持 以 及 播放 效率 方面 都 存在 着 较 大 的 不 足 。 

所 以 ， 如 果 想 要 仅仅 使 用 VideoView 就 编写 出 一 个 功能 非常 强大 的 视频 
播放 占 是 不 太 现 实 的 。 但 是 如 果 只 是 用 于 播放 一 些 游 戏 的 片头 动画 ， 或 














者 某 个 应 用 的 视频 宣传 ， 使 用 VideoView 还 是 绰绰有余 的 。 


好 了 ， 关 于 Android 多 媒体 方面 的 知识 你 已 经 学 得 足够 多 了 ， 下 面 就 让 
我 们 一 起 来 总 结 一 下 本 章 所 学 的 内 容 吧 。 








8.5 ”小 结 与 点 评 


本 章 我 们 主要 对 Android 系 统 中 的 各 种 多 媒体 技术 进行 了 学 习 ， 其 中 包 
括 通 知 的 使 用 技巧 、 调 用 摄像 尖 拍 照 、 从 相册 中 选取 照 上 请， 以 及 播放 首 
频 和 视频 文件 。 由 于 所 涉及 的 多 媒体 技术 在 模拟 占 上 很 难看 得 到 效果 ， 
因此 本 章 中 还 特意 讲解 了 在 Android 手 机 上 调试 程序 的 方法 。 


又 是 充实 饱满 的 一 章 啊 ! 现在 多 媒体 方面 的 知识 已 经 学 得 足够 多 了 ， 我 
希望 你 可 以 很 好 地 将 它们 消化 掉 ， 尤 其 是 与 通知 相关 的 内 容 ， 因 为 后 面 
的 学 习 当 中 还 会 用 到 它 。 目 前 我 们 所 学 的 所 有 东西 都 仅仅 是 在 本 地 上 进 
行 的 ， 而 实际 上 几乎 市 场 上 的 每 个 应 用 都 会 涉及 网 络 交 互 的 部 分 ， 所 以 
下 一 章 中 我 们 将 会 学 习 一 下 Android 网 络 编程 方面 的 内 容 。 














第 9 章 看 看 精彩 的 世界 一 一 使 用 网 
络 拉 术 


如 果 你 在 玩 手机 的 时 候 不 能 上 网 ， 那 你 一 定 会 感到 特别 地 村 燥 乏 味 。 没 
错 ， 现 在 早已 不 是 玩 单机 的 时 代 了 ， 无 论 是 PC、 手 机 、 平 板 ， 还 是 电 
视 ， 几 乎 部 会 具备 上 网 的 功能 ， 在 可 预见 的 未 来 ， 手 表 、 了 眼镜、 汽车 等 
设备 也 会 逐个 加 入 到 这 个 行列 ，21 世 纪 的 确 是 互联 网 的 时 代 。 


当然 ，Android 手 机 肯定 也 是 可 以 上 网 的 ， 所 以 作为 开发 者 ， 我 们 就 需 
要 考虑 如 何 利用 网 络 来 编写 出 更 加 出 色 的 应 用 程序 ， 像 QQ、 微 博 、 微 
信 等 常见 的 应 用 都 会 大 量 使 用 网 络 技术 。 本 章 主 要 会 讲述 如 何在 手机 端 
使 用 HITP 协 议和 服务 器 端 进 行 网 络 交 互 ， 并 对 服务 器 返回 的 数据 进行 
解析 ， 这 也 是 Android 中 最 常 使 用 到 的 网 络 技术 ， 下 面 就 让 我 们 一 起 来 
学 习 一 下 吧 。 





9.1 WebView 的 用 法 


有 时 候 我 们 可 能 会 碰 到 一 些 比较 特殊 的 需求 ， 比 如 说 要 求 在 应 用 程序 里 
展示 一 些 网 页 。 相 信 每 个 人 都 知道 ， 加 载 和 显示 网 页 通常 都 是 浏览 此 的 
任务 ， 但 是 需求 里 又 明确 指出 ， 不 允许 打开 系统 浏览 费 ， 而 我 们 当然 也 
不 可 能 目 己 去 编写 一 个 浏览 器 出 来 ， 这 时 应 该 怎么 办 呢 ? 


不 用 担心 ，Android 早 就 已 经 考虑 到 了 这 种 需求 ， 并 提供 了 一 个 
WebView 控 件 ， 借 助 它 我 们 就 可 以 在 自己 的 应 用 程序 里 租 入 一 个 浏览 
器 ， 从 而 非常 轻松 地 展示 各 种 各 样 的 网 页 。 


WebView 的 用 法 也 是 相当 简单， 下 面 我 们 束 通 过 一 个 例子 来 学 习 一 下 
吧 。 新 建 一 个 WebViewTest 项 目 ， 然 后 修改 activity_main.xml 中 的 代码 ， 
如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_ width="match_parent 
android:layout_height="match_parent" > 





<WebView 
android:id="@+id/web_view" 
android:layout_width="match_parent" 
android:layout_height="match_parent" /> 


</LinearLayout> 





可 以 看 到 ， 我 们 在 布局 文件 中 使 用 到 了 一 个 新 的 控件 : We 这 个 
控件 当然 也 就 是 用 来 显示 网 页 的 了 ， 这 里 的 写法 很 简单 ， 给 它 设 置 了 一 
个 id， 并 让 它 充 满 整 个 屏幕 


然后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 





@override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity main); 
WebView webView = (WebView) findViewById(R.id.web_view); 
webView.getSettings().setJavascriptEnabled(true); 
webView,.setwebViewClient(new WebViewClient()); 
webView.1loadUrl("http://www.baidu.com"); 


MainActivity 中 的 代码 也 很 短 ， 首 先 使 用 findviewById() 方 法 获取 到 了 


WebView 的 实例 ， 然 后 调用 WebView 的 getsettings() 方 法 可 以 去 设置 
一 些 浏 览 器 的 属性 ， 这 里 我 们 并 不 去 设置 过 多 的 属性 ， 只 是 调用 了 
setJavascriptEnabled() 方 法 来 让 WebView 支 持 JavaScript 脚 本 。 


接 下 来 是 非常 重要 的 一 个 部 分 ， 我 们 调用 了 WebView 的 
setwebViewclient() 方 法 ， 并 传 入 了 一 个 WebViewClient 的 实例 。 这 上段 代 
码 的 作用 是 ， 当 需要 从 一 个 网 页 跳 转 到 男 一 个 网 页 时 ， 我 们 希望 目标 网 
页 仍然 在 当前 WebView 中 显示 ， 而 不 是 打开 系统 浏览 器 。 


最 后 一 步 就 非常 简单 了 ， 调 用 WebView 的 loadurl1() 方 法 ， 并 将 网 址 传 
外 即 可 展示 相应 网 页 的 内 容 ， 这 里 惑 让 我 们 看 一 看 百度 的 首页 长 什么 
羊 吧 。 


另外 还 需要 注意 ， 由 于 本 程序 使 用 到 了 网 络 功能 ， 而 访问 网 络 是 需要 声 
明 权 限 的 ， 因 此 我 们 还 得 修改 AndroidManifest.xml 文 件 ， 并 加 入 权限 声 
明 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.webviewtest"> 

















<uses -permission android:name="android.permission.INTERNET" /> 


</manifest> 





在 开始 运行 之 前 ， 首 先 需 要 保证 你 的 手机 或 模拟 器 是 联网 的 ， 如 果 你 使 
用 的 是 模拟 器 ， 只 需 保 证 电脑 能 正常 上 网 即 可 。 然 后 就 可 以 运行 一 下 程 
序 了 ， 效 果 如 图 9.1 所 示 。 
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图 9.1 WebView 加 载 网 页 


可 以 看 到 ，WebViewTest 这 个 程序 现在 已 经 具备 了 一 个 简易 浏览 器 的 功 
能 ， 不 仅 成 功 将 百度 的 首页 展示 了 出 来 ， 还 可 以 通过 点 击 链接 浏览 更 多 
的 网 页 。 


当然 ，WebView 还 有 很 多 更 加 局 级 的 使 用 搁 巧 ， 我 们 就 不 再 继续 进行 探 
讨 了 ， 因 为 那 不 是 本 章 的 重点 。 这 里 先 介绍 了 一 下 WebView 的 用 法 ， 只 
古 硕 望 你 能 对 HITP 协 议 的 使 用 有 一 个 最 基本 的 认识 ， 接 下 来 我 们 就 要 
利用 这 个 协议 来 做 一 些 真正 的 网 络 开 发 工作 了 。 





9.2 ”使 用 HTTP 协 议 访 问 网 络 


如 果 说 真 的 要 去 深入 分 析 HTTP 协 议 ， 可 能 需要 花费 整整 一 本 书 的 篇 
幅 。 这 里 我 当然 不 会 这 么 干 ， 因 为 毕竟 你 是 跟着 我 学 习 Android 开 发 
的 ， 而 不 是 网 站 开发 。 对 于 HTTP 协 议 ， 你 只 需要 稍微 了 解 一 些 就 足够 
了 ， 它 的 工作 原理 特别 简单 ， 就 是 客户 端 向 服务 器 发 出 一 条 HTTP 请 
求 ， 服 务 器 收 到 请 求 之 后 会 返回 一 些 数据 给 客户 端 ， 然 后 客户 端 再 对 这 
些 数据 进行 解析 和 处 理 就 可 以 了 。 是 不 是 非常 简单 ? 一 个 浏览 器 的 基本 
工作 原理 也 就 是 如 此 了 。 比 如 说 上 一 节 中 使 用 到 的 WebView 控 件 ， 其 实 
也 就 是 我 们 向 百度 的 服务 器 发 起 了 一 条 HTTP 请 求 ， 接 着 服务 器 分 析出 
我 们 想 要 访问 的 是 百度 的 首页 ， 于 是 会 把 该 网 页 的 HTML 代 码 进行 返 
回 ， 然 后 WebView 再 调用 手机 浏览 器 的 内 核对 返回 的 HTML 代 码 进行 解 
析 ， 最 终 将 页 面 展 示 出 来 。 


简单 来 说 ，WebView 已 经 在 后 台 帮 有 我们 处 理 好 了 发 送 HTTP 请 求 、 接 收 
服务 响应 、 解 析 返 回 数据 ， 以 及 最 终 的 页 面 展 示 这 几 步 工作 ， 不 过 由 于 
它 封 装 得 实在 是 太 好 了 ， 反 而 使 得 我 们 不 能 那么 直观 地 看 出 HTTP 协议 
到 底 是 如 何 工 作 的 。 因 此 ， 接 下 来 就 让 我 们 通过 手动 发 送 HTTP 请 求 的 
方式 ， 来 更 加 深入 地 理解 一 下 这 个 过 程 。 

















9.2.1 ”使 用 HttpURLConnection 


在 过 去 ，Android 上 发 送 HTTP 请 求 一 般 有 两 种 方式 : 
HttpURLConnection 和 HttpClient。 不 过 由 于 HttpClient 存 在 API 数 量 过 
多 、 扩 展 困难 等 缺点 ，Android 团 队 越 来 越 不 建议 我 们 使 用 这 种 方式 。 
终于 在 Android 6.0 系 统 中 ，HttpClient 的 功能 被 完全 移 除 了 ， 标 志 着 此 功 
能 被 正式 弃 用 ， 因 此 本 小 节 我 们 就 学 习 一 下 现在 官方 建议 使 用 的 
HttpURLConnection 的 用 法 。 





首先 需要 获取 到 HttpURLConnection 的 实例 ， 一 般 只 需 new 出 一 个 URL 对 
， 并 传 入 目标 的 网 络 地 址 ， 然 后 调用 一 下 openconnection() 方 法 即 
可 ， 如 下 所 示 : 


URL url = new URL("http://www.baidu.com"); 
HttpURLConnec tion connec tion = (HttpURLConnection) url.openConnection(); 


在 得 到 了 HttpURLConnection 的 实例 之 后 ， 我 们 可 以 设置 一 下 HTTP 请 求 
所 使 用 的 方法 。 常 用 的 方法 主要 有 两 个 ;GET 和 PosT。GET 表 示 和 希望 从 服 
务 器 那里 获取 数据 ， 而 PosT 则 表示 希望 提交 数据 给 服务 器 。 写 法 如 下 : 


connection.setRequestMethod("GET"); 








接 下 来 就 可 以 进行 一 些 目 由 的 定制 7， 比 如 设置 连接 超时 、 读 取 超 时 的 
坚 秒 数 ， 以 及 服务 志和 希 望 得 到 的 一 些 消息 头等 。 这 部 分 内 容 根据 目 己 的 
实际 情况 进行 编写 ， 示 例 写法 如 下 : 


connection.setConnectTimeout(8000); 
connection.setReadTimeout (8000); 











之 后 再 调用 getInputstream() 方 法 就 可 以 获取 到 服务 器 返回 的 输入 流 
了 ， 剩 下 的 任务 就 是 对 输入 流 进 行 读 取 ， 如 下 所 示 : 


InputStream in = connection.getInputStream( ) ; 


最 后 可 以 调用 disconnect() 方 法 将 这 个 HTTP 连接 关闭 掉 ， 如 下 所 示 : 


connection.disconnect(); 


下 面 束 让 我 们 通过 一 个 具体 的 例子 来 真正 体验 一 下 HttpURLConnection 
的 用 法 。 新 建 一 个 NetworkTest 项 目 ， 首 先 修改 activity_main.xml 中 的 代 
人 码 ， 如 下 所 示 : 


<LinearLayout xmlns: android= MR //schemas.android.com/apk/res/android" 
android:orientation="verti 
android:layout_width= wt hone 
android:layout_height="match_parent" > 





<Button 
android:id="@+id/send_request" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Send Request" /> 


<ScrollView 
android:layout_width="match_parent" 
android:layout_height="match_parent" 


V 


<TextView 
android:id="@+id/response_text" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" /> 
</ScrollView> 








</LinearLayout> 


注意 这 里 我 们 使 用 了 一 个 新 的 控件 : ScrollView， 它 是 用 来 做 什么 的 

呢 ? 由 于 手机 屏幕 的 空间 一 般 都 比较 小 ， 有 些 时 候 过 多 的 内 容 一 屏 是 显 
示 不 下 的 ， 借 助 ScrollView 控 件 的 话 ， 我 们 就 可 以 以 滚动 的 形式 查看 屏 
幕 外 的 那 部 分 内 容 。 另 外 ， 布 局 中 还 放置 了 一 个 Button 和 一 个 
TextView，Button 用 于 发 送 HTTP 请 求 ，TextView 用 于 将 服务 器 返回 的 
数据 显示 出 来 。 


接着 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 
TextView responseText; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity main); 
Button sendRequest = (Button) findViewById(R.id.send_request); 
responseText = (TextView) findViewById(R.id.response text); 
sendRequest.setonclickListener(this); 


} 


@Override 
public void onClick(View v) { 
if (v.getId() == R.id.send request) { 
sendRequestwithHttpURLConnection(); 
~} 


} 


private void sendRequestwithHttpURLConnection() { 
// 开启 线程 来 发 起 网 络 请 求 
new Thread(new Runnable() { 
@override 
public void run() { 

HttpURLConnection connection = null; 

BufferedReader reader = null; 

try { 
URL url = new URL("https://www.baidu.com"); 
connection = (HttpURLConnection) url.openConnection(); 
connection.setRequestMethod( "GET"); 
connection.setConnectTimeout(8000); 
connection.setReadTimeout(8000); 
InputStream in = connection.getIinputStream(); 
// 下 面 对 获 取 到 的 输入 流 进行 读 取 
reader = new BufferedReader(new InputStreamReader (in)); 
StringBuilder response = new StringBuilder(); 
String line; 
while ((line = reader.readLine()) != null) { 

response.append(line); 


showResponse(response.toString()); 
} catch (Exception e) { 
e.printStackTrace(); 
} finally { 
if (reader != null) { 
try { 
reader .close( ); 
} catch (IOException e) { 
e.printSstackTrace(); 


~ 

+ 

if (connection != nul1) { 
connection.disconnect(); 


} 
} 
}).start(); 


private void showResponse(final String response) { 
runonUiThread(new Runnable() { 
@override 
public void run() { 
// 在 这 里 进行 UI 操作 ， 将 结果 显示 到 界面 上 
responseText .setText(response); 


}); 


可 以 看 到 ， 我 们 在 Send Request 按 钮 的 点 击 事件 里 调用 了 
sendRequestwithHttpURLConnection() 方 法 ， 在 这 个 方法 中 先是 开启 了 
一 个 子 线 程 ， 然 后 在 子 线程 里 使 用 HttpURLConnection 发 出 一 条 HTTP 请 
求 ， 请 求 的 目标 地 址 就 是 百度 的 首页 。 接 着 利用 BufferedReader 对 服务 
器 返回 的 流 进 行 读 取 ， 并 将 结果 传 入 到 了 showResponse() 方 法 中 。 而 
在 showResponse( ) 方 法 里 则 是 调用 了 一 个 runonUiThread() 方 法 ， 人 然后 在 
这 个 方法 的 匿名 类 参数 中 进行 操作 ， 将 返回 的 数据 显示 到 界面 上 。 那 么 
这 里 为 什么 要 用 这 个 runonuiThread() 方 法 呢 ? 这 是 因为 Android 是 不 人 允 
许 在 子 线程 中 进行 UI 操 作 的 ， 我 们 需要 通过 这 个 方法 将 线程 切换 到 主线 
程 ， 然 后 再 更 新 UI 元 素 。 关 于 这 部 分 内 容 ， 我 们 将 会 在 下 一 章 中 进行 详 
细 讲 解 ， 现 在 你 只 需要 记得 必须 这 么 写 就 可 以 了 。 


完整 的 一 套 流 程 束 是 这 样 ， 不 过 在 开始 运行 之 前 ， 仍 然 别 态 了 要 声明 一 
下 网 络 权 限 。 修 改 AndroidManifest.xml 中 的 代码 ， 如 下 所 示 : 


manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.networktest"> 








uses-permission android:name="android.permission.INTERNET" /> 


</manifest> 











好 了 ， 现 在 运行 一 下 程序 ， 并 点 击 Send 。 Request 按钮 ， 结 果 如 图 9.2 所 
二 


NetworkTest 


SEND REQUEST 


YPE htmil><html> <I-STATUS OK-> < 
\ tent-Type” co 








图 9.2 服务 器 啊 应 的 数据 


是 不 是 看 得 头 曙 眼花? 没 错 ， 服 务 咒 返回 给 我 们 的 就 是 这 种 HTML 代 
ee 
出 来 。 


那么 如 果 是 想 要 提交 数据 给 服务 占 应 该 上 怎么 办 呢 ? 其 实 也 不 复杂 ， 只 需 
要 将 HTTP 请 求 的 方法 改 成 PosST， 并 在 获取 输入 流 之 前 把 要 提交 的 数据 
写 出 即 可 。 注 意 每 条 数据 都 要 以 键 值 对 的 形式 存在 ， 数 据 与 数据 之 间 
0 
这 样 写 : 


Data0utputStream out = new Data0utputStream(connection.getOoutputStream( ) ) ， 
out .writeBytes("username=admin&password=123456" ) ; 























好 了 ， 相 信 你 已 经 将 HttpURLConnection 的 用 法 很 好 地 掌握 了 。 
9.2.2 ”使 用 OkHttp 


当然 我 们 并 不 是 只 能 使 用 HttpURLConnection， 完 全 没有 任何 其 他 选 
择 ， 事 实 上 在 开源 盛行 的 今天 ， 有 许多 出 色 的 网 络 通信 库 都 可 以 蔡 代 原 
生 的 HttpURLConnection， 而 其 中 OkHttp 无 疑 是 做 得 最 出 色 的 一 个 。 


OkHttp 是 由 易 易 大 名 的 Square 公司 开发 的 ， 这 个 公司 在 开源 事业 上 面 贡 
献 良 多 ， 除 了 OKkHttp 之 外 ， 还 开发 了 像 Picasso、Retrofit 等 著名 的 开源 项 
目 。OkHttp 不 仪 在 接口 封装 上 面 做 得 简单 易 用 ， 束 连 在 底层 实现 上 也 是 
自 成 一 派 ， 比 起 原生 的 HttpURLConnection， 可 以 说 是 有 过 之 而 无 不 
及 ， 现 在 已 经 成 了 广大 Android 开 发 者 首选 的 网 络 通信 库 。 那 么 本 小 节 
我 们 就 来 学 习 一 下 OkHttp 的 用 法 ，OkHttp 的 项 目 主 页 地 址 


日 


十: https://github.com/square/okhttp。 


在 使 用 OkHttp 之 前 ， 我 们 需要 先 在 项 目 中 添加 OkHttp 库 的 依赖 。 编 辑 
app/build.gradle 文 件 ， 在 dependencies 闭 包 中 添加 如 下 内 容 : 


dependencies 




















» Libs!. Tancludes tL'*: ar 
, roid.support:appcompat-v7:24.2.1" 
testCompile 'junit:junit:4.12' 
compile 'com.squareup.okhttp3:okhttp:3.4.1" 
} 





添加 上 述 依赖 会 自动 下 载 两 个 库 ， 一 个 是 OkHttp 库 ， 一 个 是 Okio 库 ， 后 
者 是 前 者 的 通信 基础 。 其 中 3.4.1 是 我 写本 书 时 OkHttp 的 最 新 版 本 ， 你 可 
以 访问 OkHttp 的 项 目 主页 来 查看 当前 最 新 的 版 本 是 多 少 。 


下 面 我 们 来 看 一 下 OkHttp 的 具体 用 法 ， 首 先 需 要 创建 一 个 OkHttpClient 
的 实例 ， 如 下 所 示 : 


OkHttpClient client = new OkHttpClient(); 





接 下 来 如 果 想 要 发 起 一 条 HTTP 请 求 ， 就 需要 创建 一 个 Request 对 象 : 


Request request = new Request.Builder().build(); 


当然 ， 上 述 代码 只 是 创建 了 一 个 空 的 Request 对 象 ， 并 没有 什么 实际 作 
用 ， Ee he ee 他 方法 来 丰富 这 
个 Request 对 象 。 比 如 可 以 通过 ur1() 方 法 来 设置 目标 的 网 络 地 址 ， 如 下 
所 示 : 





Request re Request . Se a r() 
or RE 3 addy m") 
.buil d(); 


之 后 调用 OkHttpClient 的 newcall( ) 方 法 来 创建 一 个 call 对 象 ， 并 调用 它 
的 execute() 方 法 来 发 送 请 求 并 获取 服务 器 返回 的 数据 ， 写 法 如 下 : 


Response response = client.newCall(request).execute(); 





其 中 Response 对 象 束 是 服务 器 返回 的 数据 了 ， 我 们 可 以 使 用 如 下 写法 来 
得 到 返 回 的 具体 内 容 : 


String responseData = response.body().string(); 








如 果 是 发 起 一 条 PosT 请 求 会 比 GET 请 求 稍微 复杂 一 点 ， 我 们 需要 先 构 建 
出 一 个 Request Body 对 象 来 存放 待 提交 的 参数 ， 如 下 所 示 : 


Reque SE ne new FormBody .Builder() 
add("user in" 


六 pa sswor rdgv "123456" ) 
1d(); 


然后 在 Request.Builder 中 调用 一 下 post() 方 法 ， 并 将 RequestBody 对 象 传 
入 : 


Request re Request. By side r() 
or Se ne baidu.com") 


S10 equestBody) 
‘buii d(); 


接 下 来 的 操作 就 和 GET 请 求 一 样 了 ， 调 用 execute() 方 法 来 发 送 请 求 并 获 
取 服 务 嚣 返回 的 数据 即 可 。 


好 了 ，OkHttp 的 基本 用 法 就 先 学 到 这 里 ， 本 书 中 后 面 所 有 网 络 相 关 的 功 
能 我 们 都 将 会 使 用 OkHttp 来 实现 ， 到 时 候 再 进行 进一步 的 学 习 。 那 么 现 





在 我 们 先 把 NetworkTest 这 个 项 目 改 用 OkHttp 的 方式 再 实现 一 壳 吧 。 


由 于 布局 部 分 完全 不 用 改动 ， 所 以 现在 直接 修改 MainActivity 中 的 代 
码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 





@override 
public void onClick(View v) { 
if (v.getId() == R.id.send request) { 
sendRequestwithokHttp(); 


} 


private void sendRequestwithOokHttp() { 
new Thread(new Runnable() { 
@Override 
public void run() { 
try { 


OkHttpClient client = new OkHttpClient(); 
Request request = new Request .Builder( ) 
.Url("http://www.baidu.com") 
.build(); 
Response response = client.newCall(request).execute(); 
String responseData = response.body().string(); 
showResponse(responseData); 
} catch (Exception e) { 
e.printSstackTrace(); 
} 


} 
}).start(); 





这 里 我 们 并 没有 做 太 多 的 改动 ， 只 是 添加 了 一 

个 sendRequestwithokHttp() 方 法 ， 并 在 Send Request 按 钮 的 点 击 事 件 里 
去 调用 这 个 方法 。 在 这 个 方法 中 同样 还 是 先 开 启 了 一 个 子 线程 ， 然 后 在 
子 线 程 里 使 用 OkHttp 发 出 一 条 HTTP 请 求 ， 请 求 的 目标 地 址 还 是 百度 的 
首页 ， dans a 绍 的 一 样 。 最 后 仍然 还 是 调用 了 
showResponse( ) 方 法 来 将 服务 器 返 向 的 数据 显示 到 界面 上 。 


仅仅 是 改 了 这 么 多 代码 ， 现 在 我 们 就 可 以 重新 运行 一 下 程序 了 。 点 击 
Send ” Request 按钮 后 ， 你 会 看 到 和 上 一 小 节 中 同样 的 运行 结果 ， 由 此 证 
明 ， 使 用 OkHttp 来 发 送 HTTP 请 求 的 功能 也 已 经 成 功 实现 了 。 


这 样 的 话 ， 相 信 你 就 已 经 把 HttpURLConnection 和 OkHttp 的 基本 用 法 都 
掌握 得 差不多 了 。 


























9.3 ”解析 XML 格式 数据 


通 种 情况 下 ， 每 个 需要 访问 网 络 的 应 用 程序 都 会 有 一 个 目 己 的 服务 需 ， 
我 们 可 以 回 服务 需 提 交 数 据 ， 也 可 以 从 服务 器 上 获取 数据 。 不 过 这 个 时 
候 束 出 现 了 一 个 问题 ， 这 些 数 据 到 抵 要 以 什么 样 的 格式 在 网 络 上 传输 

呢 ? 随 便 传 递 一 段 文 本 肯定 是 不 行 的 ， 因 为 为 一 方 根本 就 不 会 知道 这 段 
文本 的 用 途 是 什么 。 因 此 ， 一 般 我 们 都 会 在 网 络 上 传输 一 些 格式 化 后 的 
数据 ， 这 种 数据 会 有 一 定 的 结构 规格 和 语义 ， 当 另 一 方 收 到 数据 消 妃 之 
后 束 可 以 按照 相同 的 结构 规格 进行 解析 ， 从 而 取出 他 想 要 的 那 部 分 内 

容 。 


在 网 络 上 传输 数据 时 最 常用 的 格式 有 两 种 : XML 和 JSON， 下 面 我 们 整 
0 
入 


在 开始 之 前 我 们 还 需要 先 解决 一 个 问题 ， 就 是 从 哪儿 才能 获取 一 上 段 
XML 格式 的 数据 呢 ? 这 里 我 准备 教 你 搭建 一 个 最 简单 的 web 服务器， 在 
这 个 服务 器 上 提供 一 段 XML 文本 ， 然 后 我 们 在 程序 里 去 访问 这 个 服务 
器 ， 再 对 得 到 的 XML 文本 进行 解析 。 


搭建 Web 服 务 器 其 实 非 常 简单 ， 有 很 多 的 服务 器 类 型 可 供 选 择 ， 这 里 我 
准备 使 用 Apache 服 务 器 。 首 先 你 需要 去 下 载 一 个 Apache 服 务 器 的 安装 
包 ， 官 方 下载 地 址 是 : http://httpd.apache.org/download.cgi。 如 果 你 在 这 
个 网 址 中 找 不 到 Windows 版 的 安装 包 ， 也 可 以 直接 在 百度 上 搜 

索 “Apache 服 务 嚣 下载"， 将 会 找到 很 多 下 载 链接 。 


下 载 完成 后 双击 就 可 以 进行 安装 了， 如 图 9.3 所 示 。 




















Welcome to the Installation Wizard for 
Apache HTTP Server 2.2.9 


The Installation Wizard will install Apache HTTP Server 2,2.9 on 
your computer, To continue, dick Next., 


WARNING: This program is protected by copyright law and 
international treaties, 





图 9.3 Apache 服 务 器 安装 界面 


然后 一 直 点 击 Next， 会 提示 让 你 输入 自己 的 域名 ， 我 们 随便 填 一 个 域名 
束 可 以 了 ， 如 图 9.4 所 示 。 


server Information 


Please enter your server's information， 





Network Domain (e.g. somenet.com) 
[test.com 


Server Name (e.g. www.somenet.com): 


[www.test com 


Administrator's Email Address (e.g. webmaster@somenet,com): 
test@test.com 


Install Apache HTTP Server 2,2 programs and shortcuts for: 


(©) for All Users, on Port 80, as a Service -- Recommended., 
人 四) only for the Current User, on Port 8080, when started Manually， 


InstallShield 








图 9.4 填 入 域名 和 服务 器 信息 


接着 继续 一 直 点 击 Next， 会 提示 让 你 选择 程序 安装 的 路 径 ， 这 里 我 选择 
安装 到 CApache 目 录 下 ， 之 后 再 继续 点 击 Next 惑 可 以 完成 安装 了 。 安 
装 成 功 后 服务 器 会 自动 启动 起 来 ， 你 可 以 打开 电脑 的 浏览 器 来 验证 一 
下 。 在 地 址 栏 输入 127.0.0.1， 如 果 出 现 了 如 图 9.5 所 示 的 界面 ， 就 说 明 服 
务 器 已 经 启动 成 功 了 。 





上 127.0.0.1 


所 © 127.0.0,1 


It works! 








图 9.5 Apache 服务器 的 默认 主页 


接 下 来 进入 到 C:\Apache\htdocs 目 录 下 ， 在 这 里 新 建 一 个 名 为 
get_data.xml 的 文件 ， 然 后 编辑 这 个 文件 ， 并 加 入 如 下 XML 格式 的 内 


容 。 


<name>Google Maps</name> 
<version>1.0</version> 


<id>2</id> 
<name>Chrome</name> 
<version>2.1</version> 


<id>3</id> 
<name>Google Play</name> 
<version>2.3</version> 
</app> 
</apps> 


这 时 在 浏览 器 中 访问 http:/127.0.0.1/get_data.xml 这 个 网 址 ， 就 应 该 出 现 
如 图 9.6 所 示 的 内 容 。 


癌 127.0.0.1/get_data.xml x 


€ C |D 127.0.0.1/get dataxml 


This XL file does not appear to have any style information associated with it, The 
document tree is showmn below. 


v apps> 
vapp> 
《id>1< id> 
<rame ,Google Japscnanme> 
versior? 1, QC/ver sion> 
/app> 
vmp> 
《id>24 1d> 
<rame Chr omeC/name> 
《versior02, 1C/version> 
《app》 
<4app> 
《id234 aid》 
mame ,Google Play name> 
CversiorD2, 3C/version> 
</app> 
《fapps> 





图 9.6 在 浏览 右 验 证 XML 数据 


好 了 ， 准 备 工 作 到 此 结束 ， 接 下 来 就 让 我 们 在 Android 程 序 里 去 获取 并 
解析 这 段 XML 数据 吧 。 


9.3.1 Pull 解 析 方 式 


解析 XML 格式 的 数据 其 实 也 有 挺 多 种 方式 的 ， 本 节 中 我 们 学 习 比 较 常 
用 的 两 种 ，Pul 解 析 和 SAX 解 析 。 那 么 简单 起 见 ， 这 里 仍然 是 在 
NetworkTest 项 目的 基础 上 继续 开发 ， 这 样 我 们 束 可 以 重用 之 前 网 络 通 
言 部 分 的 代码 ， 从 而 把 工作 的 重心 放 在 XML 数据 解析 上 。 


既然 XML 格式 的 数据 已 经 提供 好 了 ， 现 在 要 做 的 就 是 从 中 解析 出 我 们 
想 要 得 到 的 那 部 分 内 容 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 








private void sendRequestwithOkHttp() { 
new Thread(new Runnable() { 
@override 
public void run() { 
Er 


OkHttpClient Ge = ne hare) 
Request reque = lder() 
// 第 让 访问 的 服 De 
.Url("http://10.0.2.2/get_data.xml") 
.build(); 
Response response = client.newCall(request).execute(); 
String responseData = response.body().string(); 
parseXMLWithPull(responseData); 
} catch (Exception e) { 
e.printSstackTrace(); 


} 
} 
}).start(); 


private void parseXMLWithPull(String xmlData) { 
电信 


XxmlPullParserFactory factory = XmlPullParserFactory.newInstance(); 
XxmlPullParser xmlPullParser = factory.newPpullParser() 
xmlPullParser.setIinput(new StringReader (xmlData)); 
int eventType = = xmlPullParser .getEventType(); 
String id 三 
String name = "" 
String version = "") 
while (eventType != XmlPullParser.END DOCUMENT) { 
String nodeName = xmlPullParser .getName(); 
switch (eventType) £ 
// 开始 解析 某 个 节 
case ripuliParser START_TAG: { 
f ("id".equals(nodeName)) { 
id = xmlPullParser.nextText(); 
} else if ("name".equals(nodeName)) { 
name = xmlPullParser.nextText(); 
} else if ("version".equals(nodeName)) { 
version = xmlPullParser.nextText(); 


break; 


} 
// 完成 解析 某 个 节点 
case XmlPullParser.END_ TAG: { 
if ("app".equals(nodeName)) { 
Log.d("MainActivity", "id is " + id); 


Log.d("MainActivity", "name is " + name); 
Log.d("MainActivity", "version is " + version); 
} 
break; 


default: 
break; 


} 
eventType = xmlPullParser.next(); 


} catch (Exception e) { 
e.printstackTrace(); 
} 


} 


可 以 看 到 ， 这 里 首先 是 将 HTTP 请 求 的 地 址 改 成 了 
http://10.0.2.2/get_data.xml，10.0.2.2 对 于 模拟 器 来 说 就 是 电脑 本 机 的 IP 
地 址 。 在 得 到 了 服务 器 返回 的 数据 后 ， 我 们 并 不 再 直接 将 其 展示 ， 而 是 
调用 了 parsexMLwithPul1() 方 法 来 解析 服务 器 返回 的 数据 。 


下 面 束 来 仔细 看 下 parsexMLwithPul1() 方 法 中 的 代码 吧 。 这 里 首先 要 获 
取 到 一 个 xmlPullParserFactory 的 实例 ， 并 借助 这 个 实例 得 

到 xmlPullParser 对 象 ， 然 后 调用 xmlPullParser 的 setInput() 方 法 将 服 
务 器 返回 的 XML 数 据 设置 进去 束 可 以 开始 解析 了 。 解 析 的 过 程 也 非常 
简单 ， 通 过 getEventType() 可 以 得 到 当前 的 解析 事件 ， 然 后 在 一 个 while 
循环 中 不 断 地 进行 解析 ， 如 果 当 
XmlPullParser.END_DOCUMENT， 说 明 解 析 工 作 还 没完 成 ， 调 











用 next() 方 法 后 可 以 获取 下 一 个 解析 事件 。 


在 while 循 环 中 ， 我 们 通过 getName() 方 法 得 到 当前 节点 的 名 字 ， 如 果 发 
现 节 点 名 等 于 id、name 或 version， 就 调用 nextText() 方 法 来 获取 节点 内 
具体 的 内 容 ， 每 当 解 析 完 一 个 app 市 点 后 就 将 获取 到 的 内 容 打 印 出 来 。 


好 了 ， 整 体 的 过 程 就 是 这 么 简单 ， 下 面 就 让 我 们 来 测试 一 下 吧 。 运 行 
NetworkTest 项 目 ， 然 后 点 击 Send ” ”Request 按钮 ， 观 察 logcat 中 的 打印 日 
志 ， 如 图 9.7 所 示 。 
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com. example. networktest D/MainActivity: id is 1 
com. example. networktest D/MainActivity: name is Google Maps 
com. example. networktest D/MainActivity: version is 1.0 

com. example. networktest D/MainActivity: id is 2 

com. example. networktest D/MainActivity: name is Chrome 

com. example. networktest D/MainActivity: version is 2.1 

com. example. networktest D/MainActivity: id is 3 

com. example. networktest D/MainActivity: name is Google Play 


com. example. networktest D/MainActivity: version is 2.3 


图 9.7 打印 从 XMIL 中 解析 出 的 数据 
可 以 看 到 ， 我 们 已 经 将 XML 数据 中 的 指定 内 容 成 功 解析 出 来 了 。 
9.3.2” SAX 解析 方式 


Pull 解 析 方 式 虽 然 非常 好 用 ， 但 它 并 不 是 我 们 唯一 的 选择 。SAX 解 析 也 
征 一 种 特别 常用 的 XML 解析 方式 ， 昌 然 它 的 用 法 比 Pull 解 析 要 复杂 一 
些 ， 但 在 语义 方面 会 更 加 清楚 。 


通常 情况 下 我 们 都 会 新 建 一 个 类 继承 自 DefaultHandler， 并 重 写 父 类 的 
5 个 方法 ， 如 下 所 示 : 


public class MyHandler extends DefaultHandler { 


@Override 
public void startDocument() throws SAXException { 


Q@override 
public void startElement(String uri, String localName, String qName，Attributes 
attributes) throws SAXException { 


@override 
public void characters(char[] ch, int start, int length) throws SAXException { 


@Override 

public void endElement(String uri, String localName, String qName) throws 
SAXException { 

} 


@override 
public void endDocument() throws SAXException { 


这 5 个 方法 一 看 就 很 清楚 吧 ? startDocument() 方 法 会 在 开始 XML 解析 的 
时 候 调 用 ，startElement() 方 法 会 在 开始 解析 某 个 节点 的 时 候 调 

用 ，characters() 方 法 会 在 获取 节点 中 内 容 的 时 候 调 用 ，endElement() 
方法 会 在 完成 解析 某 个 节点 的 时 候 调 用 ，endpocument () 方 法 会 在 完成 
整个 XML 解析 的 时 候 调 用 。 其 中 ，startELlement()、characters() 和 
endElement( ) 这 3 个 方法 是 有 参数 的 ， 从 XML 中 解析 出 的 数据 就 会 以 参 
数 的 形式 传 入 到 这 些 方 法 中 。 需 要 注意 的 是 ， 在 获取 节点 中 的 内 容 

时 ，characters() 方 法 可 能 会 被 调用 多 次 ， 一 些 换 和 了 于 符 也 被 当 作 内 容 解 
析出 来 ， 我 们 需要 针对 这 种 情况 在 代码 中 做 好 控制 。 


那 么 下 面 就 让 我 们 答 试 用 SAX 解 析 的 方式 来 实现 和 上 一 小 节 中 同样 的 功 
能 吧 。 新 建 一 个 contentHandler 类 继承 自 DefaultHandler， 并 重 写 父 类 
的 5 相 方 法 ， 如 下 所 示 : 


public class ContentHandler extends DefaultHandler { 




















private String nodeName; 
private StringBuilder id; 
private StringBuilder name; 
private StringBuilder version; 


@Override 

public void startDocument() throws SAXException { 
id = new StringBuilder(); 
name = new StringBuilder(); 
version = new StringBuilder(); 


} 


@Override 

public void startElement(String uri, String localName, String qName, Attributes 
attributes) throws SAXException { 
// 记录 当前 节点 名 
nodeName = localName; 


@override 
public void characters(char [] ch, int start, int length) throws SAXException { 
// 根据 当前 的 节点 名 判断 将 内 容 添加 到 哪 一 个 St ringBuilder 对 象 中 
if ("id".equals(nodeName)) { 
id.append(ch, start, length); 
} else if ("name".equals(nodeName)) { 
name.append(ch, start, length); 
} else if ("version".equals(nodeName)) { 
version.append(ch, start, length); 
} 


} 





Q@override 
public void endElement(String uri, String localName, String qName) throws 
SAXException { 
if ("app".equals(localName)) { 
Log.d("ContentHandler", "id is " + id.tostring().trim()); 
Log.d("ContentHandler", "name is " + name.toSstring().trim()); 
Log.d("ContentHandler", "version is " + version.toString().trim()); 
// 最 后 要 将 StringBuilder 清 空 掉 
id.setLength(0); 
name.setLength(0); 
version.setLength(0); 
} 
} 
@override 
public void endDocument( ) throws SAXException { 
Super .endDocument() ; 


可 以 看 到 ， 我 们 首先 给 id、name 和 version 节 点 分 别 定义 了 一 

个 StringBuilder 对 象 ， 并 在 startDocument() 方 法 里 对 它们 进行 了 初始 
化 。 每 当 开 始 解 析 某 个 节点 的 时 候 ，startElement() 方 法 就 会 得 到 调 
用 ， 其 中 localName 参 数 记 录 痢 当前 节点 的 名 字 ， 这 里 我 们 把 它 记 录 下 
来 。 接 着 在 解析 节点 中 具体 内 容 的 时 候 就 会 调用 characters() 方 法 ， 我 
们 会 根据 当前 的 节点 名 进行 判断 ， 将 解析 出 的 内 容 添加 到 哪 一 

个 stringBuilder 对 象 中 。 最 后 在 endElement() 方 法 中 进行 判断 ， 如 果 
app 节 点 已 经 解析 完成 ， 束 打印 出 id、name 和 version 的 内 容 。 需 要 注意 
的 是 ， 目 前 id、name 和 version 中 都 可 能 是 包括 回 车 或 换行 符 的 ， 因 此 
在 打印 之 前 我 们 还 需要 调用 一 下 trim() 方 法 ， 并 且 打 印 完成 后 还 要 
将 stringBuilder 的 内 容 清空 挥 ， 不 然 的 话 会 影响 下 一 次 内 容 的 读 取 。 


接 下 来 的 工作 就 非常 简单 了 ， 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 

















private void sendRequestwithOokHttp() { 
new Thread(new Runnable() { 
@override 
public void run() { 
try { 
OkHttpClient client = new OkHttpClient(); 
Request request = new Request.Builder() 
// 指定 访问 的 服务 器 地 址 是 电脑 本 机 
.Url("http://10.0.2.2/get_data.xml") 
.build(); 
Response response = client.newCall(request).execute(); 
String responseData = response.body().string(); 
parseXMLWithSAX(responseData); 
} catch (Exception e) { 
e.printStackTrace(); 


: 
} 
}).start(); 





private void parseXMLWithSAX(String xmlData) { 
try { 


SAXParserFactory factory = SAXParserFactory.newInstance(); 
XMLReader xmlReader = factory.newSAXParser().getXMLReader(); 
ContentHandler handler = new ContentHandler(); 

// 将 ContentHandler 的 实例 设置 到 XMLReader 中 
xmlReader .setContentHandler (handler); 
// 开始 执行 解析 





lReader .parse(new InputSource(new StringReader(xmlData))); 


在 得 到 了 服务 器 返回 的 数据 后 ， 我 们 这 次 去 调用 parseXxMLWithsAX() 方 法 

来 解析 XML 数据 。parsexMLwithsAx() 方 法 中 先是 创建 了 一 

个 SAXParserFactory 的 对 象 ， 然 后 再 获取 到 xMLReader 对 象 ， 接 着 将 我 们 

编写 的 ContentHandler 的 实例 设置 到 XMLReader 中 ， 最 后 调用 parse() 方 

法 开始 执行 解析 就 好 了 。 

在 重新 运行 一 下 程序 ， 点 击 Send Mp logcat 中 的 打印 日 
， 你 会 看 到 和 图 9.7 中 一 样 的 结 


除了 Pull 解 析 和 SAX 解 析 之 外 ， 其 实 还 有 一 种 DOM 解 析 方 式 也 算 挺 常用 
的 ， 不 过 这 里 我 们 就 不 再 展开 进行 讲解 了 ， 感 兴趣 的 话 你 可 以 自己 去 查 
阅 一 下 相关 资料 。 











9.4 解析 JSON 格 式 数据 


现在 你 已 经 掌握 了 XML 格式 数据 的 解析 方式 ， 那 么 接 下 来 我 们 要 去 学 
下 如 何 解析 JSON 格 式 的 数据 了 。 比 起 XML，JSON 的 主要 优势 在 于 
它 的 体积 更 小 ， 在 网 络 上 传输 的 时 候 可 以 更 省 流量 。 但 缺点 在 于 ， 它 的 
语义 性 较 差 ， 看 起 来 不 如 XML 直观 。 


在 开始 之 前 ， 我 们 还 需要 在 C:\Apache\htdocs 目 录 中 新 建 一 个 
get_data.json 的 文件 ， 然 后 编辑 这 个 文件 ， 并 加 入 如 下 JSON 格 式 的 内 











vagaa 3 55 60ame' :LClash: of Clans"}, 
Cad io”, hyer sions 7°0, enanes; "Boo Beach" 3 
{rid": "7" nversion": "3.5" "clash Royale}] 


这 时 在 浏览 器 中 访问 http://127.0.0.1/get_data.json 这 个 网 址 ， 就 应 该 出 现 
如 图 9.8 所 示 的 内 容 。 


口 127.0.0.1/get_datajson x 用 


C 127.0.0.1/get datajson 


{id’:”5”, “version ”5.5 “name Clash of Clans”}, 


(id :6 ，version :7.0 ，name : Boom Beach”}, 
“id :7 version “3.5 name”: Clash Rovale”}] 





图 9.8 在 浏览 器 验证 JSON 数 据 


好 了 ， 这 样 我 们 把 JSON 格 式 的 数据 也 准备 好 了 ， 下 面 就 开始 学 习 如 何 
在 Android 程 序 中 解析 这 些 数据 吧 。 


9.4.1 使 用 JSONObject 


类 似 地 ， 解 析 JSON 数 据 也 有 很 多 种 方法 ， 可 以 使 用 官方 提供 的 
JSONObject， 也 可 以 使 用 谷歌 的 开源 库 GSON。 另 外 ， 一 些 第 三 方 的 开 
源 库 如 Jackson、FastJSON 等 也 非常 不 错 。 本 节 中 我 们 整 来 学 习 一 下 前 
两 种 解析 方式 的 用 法 。 


修改 MainActivity 中 的 代码 ， 如 下 所 示 : 
public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


private void sendRequestwithOkHttp() { 
new Thread(new Runnable() { 
@Override 
Pu void run() { 
try { 


OkHttpClient client = new OkHttpClient(); 
Request request = new Poe Builder() 
// 指定 访问 的 服务 器 地 址 是 电脑 本 机 





.Url("http://10.0.2.2/get_data.json") 
.build(); 
Response response = client.newCall(request).execute(); 
String responseData = response.body().string(); 
parseJSONWithJSONObject(responseData); 
} catch (Exception e) { 
e.printStackTrace(); 
} 


} 
}).start(); 


private void parseJSONWithJSONObject(String jsonData) { 
try { 

JSONArray jsonArray = new 3 nay json a 

for (int i = 0; i < jsonArray.length(); i+ 
JSONObject jsonObject = jsonArray. det NOD et 
string id = jsonobject. getstring("id"); 
String name = jsonobject. getString("name" ) ， 
String version = jsonobject. getstring("version"); 
Log.d("MainActivity", "id is " + id); 
Log.d("MainActivity", "name is " + nal 
Log.d("MainActivity", "version is "+ vB 


} 
} catch (Exception e) { 
e.printstackTrace(); 
} 
} 


首先 记得 要 将 HTTP 请 求 的 地 址 改 成 http://10.0.2.2/get_data.json， 然 后 在 
得 到 了 服务 器 返回 的 数据 后 调用 parseJSONWithJSoNobject() 方 法 来 解析 
数据 。 可 以 看 到 ， 解 析 JSON 的 代码 真 的 非常 简单 ， 由 于 我 们 在 服务 器 
中 定义 的 是 一 个 JSON 数 组 ， 因 此 这 里 首先 是 将 服务 器 返回 的 数据 传 入 
到 了 一 个 JSoNArray 对 象 中 。 然 后 循环 通 历 这 个 JsSoNArray， 从 中 取出 的 
每 一 个 元 素 都 是 一 个 JSoNobject 对 象 ， 每 个 JSoNobject 对 象 中 又 会 包 
含 id、name 和 version 这 些 数据 。 接 下 来 只 需要 调用 getstring() 方 法 将 
这 些 数据 取出 ， 并 打印 出 来 即 可 。 


好 了 ， 就 是 这 么 简单 ! 现在 重新 运行 一 下 程序 ， 并 点 击 Send Request 按 
钮 ， 结 果 如 图 9.9 所 示 。 
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com. example. networktest D/MainActivity: id is 5 








com. example. networktest D/MainActivity: name is Clash of Clans 
com. example. networktest D/MainActivity: version is 5.5 

com. example. networktest D/MainActivity: id is 6 

com. example. networktest D/MainActivity: name is Boom Beach 
com. example. networktest D/MainActivity: version is 7.0 

com. example. networktest D/MainActivity: id is 7 

com. example. networktest D/MainActivity: name is Clash Royale 


com. example. networktest D/MainActivity: version is 3.5 
图 9.9 打印 从 JSON 中 解析 出 的 数据 
9.4.2 ”使 用 GSON 


如 果 你 认为 使 用 JSONObject 来 解析 JSON 数 据 已 经 非常 简单 了 ， 那 你 就 
太 容 易 满足 了 。 谷 歌 提 供 的 GSON 开 源 库 可 以 让 解析 JSON 数 据 的 工作 简 
单 到 让 你 不 敢 想 象 的 地 步 ， 那 我 们 肯定 是 不 能 错过 这 个 学 习 机 会 的 。 


不 过 GSON 并 没有 被 添加 到 Android 官 方 的 API 中 ， 因 此 如 果 想 要 使 用 这 
个 功能 的 话 ， 就 必须 要 在 项 目 中 添加 GSON 库 的 依赖 。 编 辑 
app/build.gradle 文 件 ， 在 dependencies 闭 包 中 添加 如 下 内 容 : 


dependencies 
compile fileTree(dir: 'libs', include: ['*.jar']) 
testCompile 'junit:junit:4.12'" 
compile 'com.android.support:appcompat-v7:24.2.1" 
compile 'com.squareup.okhttp3:okhttp:3.4.1" 
compile 'com.google.code.gson:gson:2.7" 


} 





那么 GSON 库 究竟 是 神奇 在 哪里 呢 ? 其 实 它 主 要 就 是 可 以 将 一 段 JSON 格 
自动 映射 成 一 个 对 象 ， 从 而 不 需要 我 们 再 手动 去 编写 代码 进 
行 解析 了 。 


比如 说 一 段 JSON 格 式 的 数据 如 下 所 示 : 


{"name":"Tom", "age":20} 


那 我 们 就 可 以 定义 一 个 Person 类 ， 并 加 入 name 和 age 这 两 个 字段 ， 然 后 
A 以 将 JSON 数 据 自 动 解 析 成 一 个 Person 对 
了 : 


Gson gson = new Gson(); 
Person person = gson.fromJson(jsonData, Person.class); 


如 果 需 要 解析 的 是 一 段 JSON 数 组 会 稍微 麻烦 一 点 ， 我 们 需要 借助 
TypeToken 将 期 望 解析 成 隐 归 据 关 宣 传 入 到 fronoson() 方 法 中 ， 如 下 所 
示 : 


List<Person> people = gson.fromJson(jsonData，new TypeToken<List<Person>>() {}.getType()); 


好 了 ， 基 本 的 用 法 束 是 这 样 ， 下 面 就 让 我 们 来 真正 地 尝试 一 下 吧 。 首 先 
新 增 一 个 App 类 ， 并 加 入 id、name 和 version 这 3 个 字段 ， 如 下 所 示 : 


public class App { 
private String id; 
private String name; 
private String version; 
public String getId() { 
urn id; 
} 
public void setId(String id) { 
is.i id; 


public String getName() { 
return name; 
} 


public void setName(String name) { 
this.name = name 


} 

P 让 String td 小 
eturn ver 

} 


public void setVersion(String version) { 
this.version = version; 


} 


然后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


private void sendRequestwithOokHttp() { 
new Thread(new Runnable() { 
@Override 
public void run() { 
tr 


OkHttpClient client = new OkHttpClient(); 
Request request = new Request.Builder() 


// 指定 访问 的 服务 器 地 址 是 电脑 本 机 
Url("http://10.0.2.2/get_data.json") 
.build(); 

Response response = client.newCall(request).execute(); 

String responseData = response.body().string(); 

parseJSONWithGSON(responseData); 

} catch (Exception e) { 
e.printStackTrace(); 


} 
} 
}).start(); 


private void parseJSONWithGSON(String jsonData) { 

Gson gson = new Gson(); 

List<App> appList = gson.fromJson(jsonData, new TypeToken<List<App>>() 
{}.getType()); 

for (App app : appList) { 
Log.d("MainActivity", "id is " + app.getId()); 
Log.d("MainActivity", "name is " + app.getName()); 
Log.d("MainActivity", "version is " + app.getVersion()); 








现在 重新 运行 程序 ， 点 击 Send Request 按 钮 后 观察 logcat 中 的 打印 日 志 ， 
你 会 看 到 和 图 9.9 中 一 样 的 结果 。 


好 了 ， 这 样 我 们 就 算是 把 XML 和 JSON 这 两 种 数据 格式 最 常用 的 几 种 解 
析 方 法 都 学 习 完 了 ， 在 网 络 数据 的 解析 方面 ， 你 已 经 成 功 毕业 了 。 


9.5 ”网 络 编程 的 最 佳 实践 


目前 你 已 经 掌握 了 HttpURLConnection 和 OkHttp 的 用 法 ， 知 道 了 如 何 发 

起 HTTP 请 求 ， 以 及 解析 服务 器 返回 的 数据 ， 但 也 许 你 还 没有 发 现 ， 之 
前 我 们 的 写法 其 实 是 很 有 问题 的 。 因 为 一 个 应 用 程序 很 可 能 会 在 许多 地 
方 都 使 用 到 网 络 功能 ， 而 发 送 HTTP 请 求 的 代码 基本 都 是 相同 的 ， 如 果 
这 显然 是 非常 兰 劲 的 做 
法 。 


没 错 ， 通 常情 况 下 我 们 都 应 该 将 这 些 通 用 的 网 络 操作 提取 到 一 个 公共 的 
类 里 ， 并 提供 一 个 静态 方法 ， 当 想 要 发 起 网 络 请 求 的 时 候 ， 只 需 简 单 地 
调用 一 下 这 个 方法 即 可 。 比 如 使 用 如 下 的 写法 : 


public class HttpUtil { 








public static String sendHttpRequest(String address) { 

HttpURLConnection connection = null; 

try { 
URL url = new URL(address); 
connection = (HttpURLConnection) url.openConnection(); 
connection.setRequestMethod( "GET"); 
connection.setConnectTimeout(8000); 
connection.setReadTimeout(8000); 
connection.setDoInput(true); 
connection.setDoOutput (true); 
InputStream in = connection.getInputStream( ) ; 
BufferedReader reader = new BufferedReader(new InputStreamReader (in)); 
StringBuilder response = new StringBuilder(); 
String line; 
while ((line = reader.readLine()) != null) { 

response.append(line); 


return response.toSstring(); 
} catch (Exception e) { 
e.printSstackTrace(); 
return e.getMessage(); 
} finally { 
if (connection != null) { 
connection.disconnect(); 
} 





以 后 每 当 需 要 发 起 一 条 HTTP 请 求 的 时 候 就 可 以 这 样 写 ; 


String address = "http://www.baidu.com"; 
String response = HttpUtil.sendHttpRequest(address); 


在 获取 到 服务 器 啊 应 的 数据 后 ， 我 们 束 可 以 对 它 进行 解析 和 处 理 了 。 但 
是 需要 注意 ， 网 络 请 求 通 弟 都 是 属于 耗 时 操作 ， 而 sendHttpRequest() 方 
法 的 内 部 并 没有 开启 线程 ， 这 样 束 有 可 能 导致 在 调用 sendHttpRequest() 











方法 的 时 候 使 得 主线 程 被 阻 暑 住 。 


你 可 能 会 说 ， 很 简单 嘛 ， 在 sendHttpRequest() 方 法 内 部 开启 一 个 线程 不 
1 其 实 没 有 你 想象 中 的 那么 容易 ， 因 为 如 果 我 们 
在 sendHttpRequest() 方 法 中 开启 了 一 个 线程 来 发 起 HTTP 请 求 ， 那 么 服 
务 器 响应 的 数据 是 无 法 进行 返回 的 ， 所 有 的 耗 时 逻辑 都 是 在 子 线程 里 进 
行 的 ，sendHttpRequest() 方 法 会 在 服务 器 还 没 来 得 及 啊 应 的 时 候 束 执行 
结束 了 ， 当 然 也 就 无 法 返回 啊 应 的 数据 了 。 


那么 遇 到 这 种 情况 时 应 该 怎么 办 呢 ? 其 实 解决 方法 并 不 难 ， 只 需要 使 用 
Java 的 同调 机 制 就 可 以 了 ， 下 面 就 让 我 们 来 学 习 一 下 回调 机 制 到 底 是 如 
可 使 用 的 。 


首先 需要 定义 一 个 接口 ， 比 如 将 它 命 名 成 HtpCallbackListener， 代 码 如 
下 所 示 : 


public interface HttpCallbackListener { 





void onFinish(String response); 


void onError(Exception e); 


可 以 看 到 ， 我 们 在 接口 中 定义 了 两 个 方法 ，onFinish() 方 法 表示 当 服 务 
器 成 功 响 应 我 们 请 求 的 时 候 调 用 ，onError() 表 示 当 进行 网 络 操作 出 现 
错误 的 时 候 调 用 。 这 两 个 方法 都 市 有 参数 ，onFinish() 方 法 中 的 参数 代 
表 看 服务 顷 迟 回 的 数据 ， 而 onError() 方 法 中 的 参数 记录 看 错误 的 详细 


半 : 辐 
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接着 修改 HttpUtil 中 的 代码 ， 如 下 所 示 : 


public class HttpUtil { 


public static void sendHttpRequest(final String address, final 
HttpCallbackListener listener) { 
new Thread(new Runnable() { 
@override 
public void run() { 
HttpURLConnection connection = null; 
try { 
URL url = new URL(address); 
connection = (HttpURLConnection) url.openConnection(); 
connection.setRequestMethod( "GET"); 
connection.setCconnectTimeout(8000); 
connection.setReadTimeout(8000); 
connection.setDoInput(true); 
connection.setDoOutput(true); 
InputStream in = connection.getInputStream(); 
BufferedReader reader = new BufferedReader(new InputStreamReader 
(in 
St nr response = new StringBuilder(); 
String 1i 
while CIine = reader.readLine()) != null) { 
response.append(line); 


if (listener != null) { 
// 回调 onFinish( ) 方 法 
listener.onFinish(response.toSstring()); 


} 
} catch (Exception e) { 
i istener != null) { 
回调 onError() 方 法 
listener .onError(e); 
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} finally { 
if (connection != null) { 
connection.disconnect(); 
} 
} 


} 
}).start(); 


我 们 首先 给 sendHttpRequest( ) 方 法 添加 了 一 个 HttpcallbackListener 参 
数 ， 并 在 方法 的 内 部 开启 了 一 个 子 线程 ， 然 后 在 子 线 程 里 去 执行 具体 的 
网 络 操作 。 注 意 ， 子 线程 中 是 无 法 通过 return 语 句 来 返回 数据 的 ， 因 此 
这 里 我 们 将 服务 器 响应 的 数据 传 入 了 HttpCallbackListener 的 onFinish( ) 
方法 中 ， 如 果 出 现 了 有 弄 弟 就 将 异种 原因 传 入 到 onError() 方 法 中 。 





现在 sendHttpRequest() 方 法 接收 两 个 参数 了 ， 因 此 我 们 在 调用 它 的 时 候 
还 需要 将 HttpCallbackListener 的 实例 传 入 ， 如 下 所 示 : 


HttpUtil.sendHttpRequest(address, new HttpCallbackListener() { 
@override 


public void onFinish(String response) { 
// 在 这 里 根据 返回 内 容 执 行 具体 的 逻辑 


@override 
public void onError(Exception e) { 
// 在 这 里 对 异常 情况 进行 处 理 


这 样 的 话 ， 当 服务 器 成 功 啊 应 的 时 候 ， 我 们 就 可 以 在 onFinish() 方 法 里 
对 啊 应 数据 进行 处 理 了 。 类 似 地 ， 如 果 出 现 了 异 稼 ， 就 可 以 

在 onError() 方 法 里 对 异常 情况 进行 处 理 。 如 此 一 来 ， 我 们 就 巧妙 地 利 
用 回调 机 制 将 啊 应 数据 成 功 返 回 给 调用 方 了 。 


不 过 你 会 发 现 ， 上 述 使 用 HttpURLConnection 的 写法 总 体 来 说 还 是 比较 
复杂 的 ， 那 么 使 用 OkHttp 会 变 得 简单 吗 ? 答案 是 肯定 的 ， 而 且 要 简单 得 
多 ， 下 面 我 们 来 具体 看 一 下 。 在 HttpUtil 中 加 入 一 

个 sendokHttpRequest() 方 法 ， 如 下 所 示 : 


public class HttpUtil { 





public static void send0kHttpRequest(String address, okhttp3.Callback callback) { 
OkHttpClient client = new OkHttpClient(); 
Request request = new Request.Builder() 


.Url(address) 


.build(); 
client.newCall(request).enqueue(callback); 


} 


可 以 看 到 ， sendokHttpRequest() 方 法 中 有 一 | okhttp3.callback 参 数 ， 
这 个 是 OkHttp 库 中 自 带 的 一 个 回调 接口 ， 类 似 于 我 们 刚才 自己 编写 的 
HttpCallbackListener。 然 后 在 client .newcall( ) 之 后 没有 像 之 前 那样 一 
直 调 用 execute() 方 法 ， 而 是 调用 了 一 个 enqueue() 方 法 ， 并 把 
okhttp3.Callback 参 数 传 入 。 相 信和 聪明 的 你 已 经 猪 到 了 ，OkHttp 

在 enqueue() 方 法 的 内 部 已 经 帮 我 们 开 好 子 线程 了 ， 人 然后 会 在 子 线程 中 
去 执行 HTTP 请 求 ， 并 将 最 终 的 请 求 结 果 回 调 到 okhttp3.callback 当 中 。 


那么 我 们 在 调用 sendokHttpRequest() 方 法 的 时 候 就 可 以 这 样 写 : 


HttpUtil.sendOkHttpRequest("http://www.baidu.com", new okhttp3.callback() { 


Q@Override 
public void onResponse(Call call, Response response) throws IOException { 
// 得 到 服务 器 返回 的 具体 内 容 
String responseData = response.body().string(); 
} 


@override 

public void onFailure(Call call, IOException e) { 
// 在 这 里 对 异常 情况 进行 处 理 
} 


由 此 可 以 看 出 ，OkHttp 的 接口 设计 得 确实 非常 人 性 化 ， 它 将 一 些 常 用 的 
功能 进行 了 很 好 的 封装 ， 使 得 我 们 只 需 编写 少量 的 代码 就 能 完成 较为 复 
杂 的 网 络 操作 。 当 然 这 并 不 是 OkHttp 的 全 部 ， 后 面 我 们 还 会 继续 学 习 它 
的 其 他 相关 知识 。 


另外 需要 注意 的 是 ， 不 管 是 使 用 HttpURLConnection 还 是 OkHttp， 最 终 
的 回调 接口 都 还 是 在 子 线程 中 运行 的 ， 因 此 我 们 不 可 以 在 这 里 执行 任何 
的 UI 操作 ， 除 非 借助 runonuiThread() 方 法 来 进行 线程 转换 。 人 至 于 具体 
的 原因 ， 我 们 很 快 就 会 在 下 一 章 中 学 习 到 了 。 

















9.6 ”小 结 与 点 评 


本 章 中 我 们 主要 学 习 了 在 Android 中 使 用 HTTP 协 议 来 进行 网 络 交互 的 知 
识 ， 虽 然 Android 中 支持 的 网 络 通信 协议 有 很 多 种 ， 但 HTTP 协 议 无 疑 是 
最 常用 的 一 种 。 通 常 我 们 有 两 种 方式 来 发 送 HTTP 请 求 ， 分 别 是 
HttpURLConnection 和 OkHttp， 相 信 这 两 种 方式 你 都 已 经 很 好 地 掌握 

全 





接着 我 们 又 学 习 了 XML 和 JSON 格 式 数 据 的 解析 方式 ， 因 为 服务 器 啊 应 
给 我 们 的 数据 一 般 都 是 属于 这 两 种 格式 的 。 无 论 是 XML 还 是 JSON， 它 
们 各 自 又 拥有 多 种 解析 方式 ， 这 里 我 们 只 是 学 习 了 最 常用 的 几 种 ， 如 果 
以 后 你 的 工作 中 还 需要 用 到 其 他 的 解析 方式 ， 可 以 自行 去 学 习 。 


本 章 的 最 后 同样 是 最 佳 实践 环节 ， 在 这 次 的 最 佳 实践 中 ， 我 们 主要 学 习 
了 如 何 利用 Java 的 回调 机 制 来 将 服务 器 啊 应 的 数据 进行 返回 。 其 实 除 此 
之 外 ， 还 有 很 多 地 方 都 可 以 使 用 到 Java 的 回调 机 制 ， 而 望 你 能 举 一 反 
三 ， 以 后 在 其 他 地 方 需要 用 到 回调 机 制 时 都 能 够 灵活 地 使 用 。 


在 进行 了 一 章 多 媒体 和 一 章 网 络 的 相关 知识 学 习 后 ， 你 是 售 想 起 来 
Android 四 大 组 件 中 还 剩 一 个 没有 学 过 呢 ! 那么 下 面 就 让 我 们 进入 到 
Android 服 务 的 学 习 旅程 之 中 。 

















第 10 草 ”后台 默默 的 开动 着 一 一 榨 宛 
服务 


记得 在 我 上 大 学 的 时 候 ，iPhone 是 属于 少数 人 才 拥 有 的 稀有 物品 ， 
Android 甚 至 还 没 面 世 ， 那 个 时 候 全 球 的 手机 市 场 是 由 诡 基 亚 统治 大 
的 。 当 时 我 觉得 话 基 亚 的 Symbian 操作 系统 做 得 特别 出 色 ， 因 为 比 起 一 
般 的 手机 ， 它 可 以 文 持 后 全 功能。 那个 时 候 能 够 一 边 打 着 电话 、 听 着 音 
乐 ， 一 边 在 后 台 挂 着 QQ 是 件 非常 酷 的 事情 。 所 以 我 也 曾经 单纯 地 认 
为 ， 文 持 后 全 的 手机 就 是 智能 手机 。 


而 如 今 ，Symbian 早 已 风光 不 再 ，Android 和 iOS 几 乎 占据 了 智能 手机 全 
部 的 市 场 份 额 。 在 这 两 大 移动 操作 系统 中 ，iOS 一 开始 是 不 文 持 后 台 
的 ， 后 来 逐渐 意识 到 这 个 功能 的 重要 性 ， 才 加 入 了 后 台 功 能 。 而 
Android 则 是 治 用 了 Symbian 的 老 习 惯 ， 从 一 开始 就 文 持 后 台 功 能 ， 这 使 
得 应 用 程序 即使 在 关闭 的 情况 下 仍然 可 以 在 后 台 继 续 运行 。 不 管 怎么 
说 ， 后 台 功 能 属于 四 大 组 件 之 一 ， 其 重要 程度 不 言 而 喻 ， 那 么 我 们 自然 
要 好 好 学 习 一 下 它 的 用 法 了 。 























10.1 服务 是 什么 


服务 (Service〉 是 Android 中 实现 程序 后 台 运 行 的 解决 方案 ， 它 非常 适 
合 去 执行 那些 不 需要 和 用 户 交 互 而 且 还 要 求 长 期 运行 的 任务 。 服 务 的 运 
行 不 依赖 于 任何 用 户 界 面 ， 即 使 程序 被 切换 到 后 人 台 ， 或 者 用 户 打 开 了 为 
外 一 个 应 用 程序 ， 服 务 仍然 能 够 保持 正常 运行 。 


不 过 需要 注意 的 是 ， 服 务 并 不 是 运行 在 一 个 独立 的 进程 当中 的 ， 而 是 依 
赖 于 创建 服务 时 所 在 的 应 用 程序 进程 。 当 菏 个 应 用 程序 进程 被 杀 挤 时 ， 
所 有 依赖 于 该 进程 的 服务 也 会 俘 止 运行 。 


另外 ， 也 不 要 被 服务 的 后 台 概 念 所 迷惑 ， 实 际 上 服务 并 不 会 目 动 开 局 线 
程 ， 所 有 的 代码 都 是 默认 运行 在 主线 程 当 中 的 。 也 就 是 说 ， 我 们 需要 在 
服务 的 内 部 手动 创建 子 线 程 ， 并 在 这 里 执行 具体 的 任务 ， 人 否则 束 有 可 能 
出 现 主线 程 被 阻塞 住 的 情况 。 那 么 本 章 的 第 一 尝 课 ， 我 们 融 先 来 学 习 一 
下 关于 Android 多 线程 编程 的 知识 。 








10.2 ” Android 多 线程 编程 


熟悉 Java 的 你 ， 对 多 线程 编程 一 定 不 会 陌生 吧 。 当 我 们 需要 执行 一 些 耗 
时 操作 ， 比 如 说 发 起 一 条 网 络 请 求 时 ， 考 虑 到 网 速 等 其 他 原因 ， 服 务 器 
未 必 会 立刻 虽 应 我 们 的 请 求 ， 如 宋 不 将 这 类 操作 放 在 子 线程 里 去 运行 ， 
就 会 导致 主线 程 被 阻 蹇 住 ， 从 而 影响 用 户 对 软件 的 正常 使 用 。 那 么 惑 让 
我 们 从 线程 的 基本 用 法 开始 学 习 吧 。 


10.2.1 线程 的 基本 用 法 
Android 多 线程 编程 其 实 并 不 比 Java 多 线程 编程 特殊 ， 基 本 都 是 使 用 相同 


的 语法 。 比 如 说 ， 定 义 一 个 线程 只 需要 新 建 一 个 类 继承 目 Thread， 然 后 
重 写 父 类 的 run() 方 法 ， 并 在 里 面 编写 耗 时 逻辑 即 可 ， 如 下 所 示 : 


class MyThread extends Thread { 





Q@override 
public void run() { 
// 处 理 具体 的 逻辑 


那么 该 如 何 启 动 这 个 线程 呢 ? 其 实 也 很 简单 ， 只 需要 new 出 MyThread 的 
实例 ， 然 后 调用 它 的 start() 方 法 ， 这 样 run() 方 法 中 的 代码 就 会 在 子 线 
程 当中 运行 了 ， 如 下 所 示 : 


new MyThread().start(); 


当然 ， 使 用 继承 的 方式 耦合 性 有 点 高 ， 更 多 的 时 候 我 们 都 会 选择 使 用 实 
现 Runnable 接 口 的 方式 来 定义 一 个 线程 ， 如 下 所 示 : 


class MyThread implements Runnable { 





@overri 
un() { 


ide 
public void r 
// 处 理 具体 的 逻辑 
} 





如 果 使 用 了 这 种 写法 ， 启 动 线程 的 方法 也 需要 进行 相应 的 改变 ， 如 下 所 


MyThread myThread = new MyThread() 
new Thread(myThread).start(); 


可 以 看 到 ，Thread 的 构造 函数 接收 一 个 Runnable 参 数 ， 而 我 们 new 出 的 
MyThread 下 是 一 个 实现 了 Runnable 接 口 的 对 象 ， 所 以 可 以 直接 将 它 传 入 
到 Thread 的 构造 函数 里 。 接着 调用 Thread 的 start() 方 法 ， run() 方 法 中 
的 代码 就 会 在 子 线程 当中 运行 了 。 


当然 ， 如 果 你 不 想 专 门 再 定义 一 个 类 去 实现 Runnable 接 口 ， 也 可 以 使 用 
匿名 类 的 方式 ， 这 种 写法 更 为 第 见 ， 如 下 所 示 : 


new Thread(new Runnable() { 











Q@override 

public void run() { 
// 处 理 具 体 的 逻辑 

} 


}).start(); 


以 上 几 种 线程 的 使 用 方式 相信 你 都 不 会 感到 陌生 ， 因 为 在 Java 中 创建 和 
局 动 线程 也 是 使 用 同样 的 方式 。 了 解 了 线程 的 基本 用 法 后 ， 下 面 我 们 来 
看 一 下 Android 多 线程 编程 与 Java 多 线程 编程 不 同 的 地 方 。 


10.2.2 ”在 子 线程 中 更 新 UI 


和 许多 其 他 的 GUI 库 一 样 ，Android 的 UI 也 是 线程 不 安全 的 。 也 就 是 说 ， 
如 果 想 要 更 新 应 用 程序 里 的 UI 元 素 ， 则 必须 在 主线 程 中 进行 ， 否 则 就 会 
出 现 异常 。 


眼见 为 实 ， 让 我 们 通过 一 个 具体 的 例子 来 验证 一 下 吧 。 新 建 一 个 
AndroidThreadTest 项 目 ， 然 后 修改 activity_main.xml 中 的 代码 ， 如 下 所 
作 \: 








lns:android="http://schemas.android.com/apk/res/android" 
="match_parent" 
eight="match_parent"> 


droid:id=" d/text" 

d d:layout_width="wrap_content" 
d d:layout_height="wrap_content" 
d d:layout_centerIn nt="true" 


android:text="Hello world" 
android:textSize="20sp" /> 


</RelativeLayout> 





布局 文件 中 定义 了 两 个 控件 ，TextView 用 于 在 屏幕 的 正中 央 显 示 一 个 
Hello ” world 字符 串 ，Button 用 于 改变 TextView 中 显示 的 内 容 ， 我 们 希望 
在 点 击 Button 后 可 以 把 TextView 中 显示 的 字符 串 改 成 Nice to meet you。 


接 下 来 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 
private TextView text; 


@Ooverride 
protected void onCreate(Bundle savedInstanceState) { 
super .oncCcreate(SavedInstanceState) 
setcontentView(R: layout.activity_main); 
text = (TextView) findViewById(R.id.text); 
Button changeText = (Button) findViewById(R.id.change_ text); 
changeText .setonClickListener(this); 
} 
@override 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.change_ text: 
new Thread(new Runnable() { 
@override 
public void run() { 
text.setText("Nice to meet you"); 


} 
有 start(); 
k; 


可 以 看 到 ， 我 们 在 Change Text 按 钮 的 点 击 事件 里 面 开 局 了 一 个 子 线程 ， 
然后 在 子 线程 中 调用 TextView 的 setText() 方 法 将 显示 的 字符 串 改 成 Nice 
to ” meet you。 代 码 的 逻辑 非常 简单 ， 只 不 过 我 们 是 在 了 了 线程 中 更 新 UI 
的 。 现 在 运行 一 下 程序 ， 并 点 击 Change Text 按 钮 你 会 发 现 程序 果然 朋 

沉 了 ， 如 图 10.1 所 示 。 














ai 11:38 


AndroidThreadTest has stopped 


GC 0penappagain 





图 10.1 在 子 线程 中 更 新 UI 导 致 朋 误 


然后 观察 logcat 中 的 错误 日 志 ， 可 以 看 出 是 由 于 在 子 线程 中 更 新 UI 所 导 
致 的 ， 如 图 10.2 所 示 。 


android. view.YiewRootImp1hcalledFrorNrongThreadExcebtion: Only the original 
thread that created a view hierarchy can touch its views. 








图 10.2 崩 尝 的 详细 信息 


由 此 证 实 了 Android 确 实 是 不 允许 在 子 线程 中 进行 UI 操作 的 。 但 是 有 些 
时 候 ， 我 们 必须 在 子 线程 里 去 执行 一 些 耗 时 任务 ， 然 后 根据 任务 的 执行 
结果 来 更 新 相应 的 UI 控件 ， 这 该 如 何 是 好 呢 ? 


对 于 这 种 情况 ，Android 提 供 了 一 套 异 步 消息 处 理 机 制 ， 完 美 地 解决 了 
在 子 线 程 中 进行 UI 操作 的 问题 。 本 小 节 中 我 们 先 来 学 习 一 下 异步 消息 处 
理 的 使 用 方法 ， 下 一 小 节 中 再 去 分 析 它 的 原理 。 


修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 
public static final int UPDATE_TEXT = 1; 
private TextView text; 
private Handler handler = new Handler() { 
public void handleMessage(Message msg) { 
Switch (msg.what) { 
case UPDATE_TEXT: 
// 在 这 里 可 以 进行 UI 操作 
text.setText("Nice to meet you"); 


brea 
default: 
break 
} 
}; 
@override 


public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.change_ text: 
new Thread(new Runnable() { 
@override 
public void run() { 
Message message = new Message(); 
message.what = UPDATE_TEXT; 
handler .sendMessage(message); // 将 Message 对 象 发 送出 去 


} 
}).start(); 
break; 


这 里 我 们 先是 定义 了 一 个 整 型 常量 UPDATE_TEXT， 用 于 表示 更 新 
TextView 这 个 动作 。 然 后 新 增 一 个 Handler 对 象 ， 并 重 写 父 类 的 
handleMessage() 方 法 ， 在 这 里 对 具体 的 Message 进 行 处 理 。 如 果 发 现 
Message 的 what 字 上段 的 值 等 于 UPDATE_TEXT， 就 将 TextView 显 示 的 内 容 改 
成 Nice to meet you。 


下 面 再 来 看 一 下 Change Text 按 钮 的 点 击 事 件 中 的 代码 。 可 以 看 到 ， 这 次 
我 们 并 没有 在 子 线程 里 直接 进行 UI 操作 ， 而 是 创建 了 一 

个 Message (android.os.Message) 对 象 ， 并 将 它 的 what 字 段 的 值 指定 
为 UPDATE_TEXT， 然 后 调用 Handler 的 sendMessage() 方 法 将 这 条 Message 
发 送出 去 。 很 快 ，Handler 惑 会 收 到 这 条 Message， 并 在 handleMessage( ) 
方法 中 对 它 进 行 处 理 。 注 意 此 时 handleMessage() 方 法 中 的 代码 就 是 在 主 
线程 当中 运行 的 了 ， 所 以 我 们 可 以 放心 地 在 这 里 进行 UI 操作 。 接 下 来 对 








Message 携 带 的 what 字 段 的 值 进行 判断 ， 如 果 等 于 UPDATE_TEXT， 就 将 
TextView 显 示 的 内 容 改 成 Nice to meet you。 


现在 重新 运行 程序 ， 可 以 看 到 屏幕 的 正中 央 显 示 着 Hello world。 然 后 点 
击 一 下 Change Text 按 钮 ， 显 示 的 内 容 就 被 蔡 换 成 Nice to meet you， 如 图 
10.3 所 示 。 





wi 吕 12:40 








AndroidThreadTest 


CHANGE TEXT 


Nice to meet you 





图 10.3 成 功 蔡 换 显示 的 文字 


这 样 你 就 已 经 掌握 了 Android 寞 步 消 息 处 理 的 基本 用 法 ， 使 用 这 种 机 制 
就 可 以 出 色 地 解决 择 在 子 线 程 中 更 新 UI 的 问题 。 不 过 奴 怕 你 对 它 的 工作 
原理 还 不 是 很 清楚 ， 下 面 我 们 残 来 分 析 一 下 Android 腊 步 消 恕 处 理 机 制 
到 后 是 如 何 工作 的 。 





10.2.3 ”解析 异步 消息 处 理 机 制 


Android 中 的 异步 消息 处 理 主 要 由 4 个 部 分 组 成 : Message、Handler、 
MessageQueue 和 Looper。 其 中 Message 和 Handler 在 上 一 小 节 中 我 们 已 经 
接触 过 了 ， 而 MessageQueue 和 Looper 对 于 你 来 说 还 是 全 新 的 概念 ， 下 面 
我 就 对 这 4 个 部 分 进行 一 下 简要 的 介绍 。 


1. 





Message 


Message 是 在 线程 之 间 传 递 的 消息 ， 它 可 以 在 内 部 携带 少量 的 信 
息 ， 用 于 在 不 同 线程 之 间 交 换 数据 。 上 一 小 节 中 我 们 使 用 到 了 
Message 的 what 字 段 ， 除 此 之 外 还 可 以 使 用 arg1 和 arg2 字 段 来 携带 
一 些 整 型 数据 ， 使 用 obj 字 段 携带 一 个 object 对 象 。 

















2. Handler 
Handler 顾 名 思 义 也 束 是 处 理 者 的 意思 ， 它 主要 是 用 于 发 送 和 处 理 
消息 的 。 发 送 消息 一 般 是 使 用 Handler 的 sendMessage() 方 法 ， 而 发 
出 的 消息 经 过 一 系列 地 轧 转 处 理 后 ， 最 终 会 传递 到 Handler 的 
handleMessage( ) 方 法 中 。 

3. MessageQueue 
MessageQueue 是 消 恩 队列 的 意思 ， 它 主要 用 于 存放 所 有 通过 
Handler 发 送 的 消息 。 这 部 分 消息 会 一 直 存 在 于 消息 队列 中 ， 等 待 
被 处 理 。 每 个 线程 中 只 会 有 一 个 MessageQueue 对 象 。 

4. Looper 


Looper 是 每 个 线程 中 的 MessageQueue 的 管家 ， 调 用 Looper 的 loop() 
方法 后 ， 束 会 进入 到 一 个 无 限 循 环 当 中 ， 然 后 每 当 发 现 

MessageQueue 中 存在 一 条 消 忠 ， 束 会 将 它 取 出 ， 并 传 圳 到 Handler 
的 handleMessage() 方 法 中 。 每 个 线程 中 也 只 会 有 一 个 Looper 对 象 。 


了 解 了 Message、Handler、MessageQueue 以 及 Looper 的 基本 概念 后 ， 我 
们 再 来 把 异步 消 恩 处 理 的 整个 流程 梳理 一 裔 。 首 先 需 要 在 主线 程 当 中 创 
建 一 个 Handler 对 象 ， 并 重 写 handleMessage() 方 法 。 然 后 当 子 线程 中 需 





要 进行 UI 操 作 时 ， 就 创建 一 个 Message 对 象 ， 并 通过 Handler 将 这 条 消息 
发 送出 去 。 之 后 这 条 消息 会 被 添加 到 MessageQueue 的 队列 中 等 竺 被 处 

理 ， 而 Looper 则 会 一 直 尝 试 从 MessageQueue 中 取出 竺 处理 消息 ， 最 后 分 
发 回 Handler 的 handleMessage() 方 法 中 。 由 于 Handler 是 在 主线 程 中 创建 
的 ， 所 以 此 时 handleMessage() 方 法 中 的 代码 也 会 在 主线 程 中 运行 ， 于 是 
我 们 在 这 里 就 可 以 安心 地 进行 UI 操 作 了 。 整 个 异步 消息 处 理 机 制 的 流程 


示意 图 如 图 10.4 所 示 ， 
取出 和 外 理 消息 \ 














MessageQueue 回调 dispatchMessage() 方 法 










Message 






handleMessage() 


图 10.4 异步 消息 处 理 机 制 流 程 示意 


一 条 Message 经 过 这 样 一 个 流程 的 轧 转 调用 后 ， 也 束 从 子 线程 进入 到 了 
主线 程 ， 从 不 能 更 新 UI 变 成 了 可 以 更 新 UI， 整 个 异步 消息 处 理 的 核心 思 
想 也 就 是 如 此 。 


而 我 们 在 9.2.1 小 节 中 使 用 到 的 runonuiThread() 方 法 其 实 就 是 一 个 异步 消 
恩 处 理 机 制 的 接口 封装 ， 它 虽然 表面 上 看 起 来 用 法 更 为 简单 ， 但 其 实 背 











后 的 实现 原理 和 图 10.4 中 的 描述 是 一 模 一 样 的 。 
10.2.4 使 用 AsyncTask 


不 过 为 了 更 加 方便 我 们 在 子 线程 中 对 UI 进行 操作 ，Android 还 提供 了 男 
外 一 些 好 用 的 工具 ， 比 如 AsyncTask。 借 助 AsyncTask， 即 使 你 对 异步 消 
妃 处 理 机 制 完 全 不 了 解 ， 也 可 以 十 分 简单 地 从 子 线程 切换 到 主线 程 。 当 
然 ，AsyncTask 背 后 的 实现 原理 也 是 基于 异步 消息 处 理 机 制 的 ， 只 是 
Android 帮 我 们 做 了 很 好 的 封闭 而 已 。 


首先 来 看 一 下 AsyncTask 的 基本 用 法 ， 由 于 AsyncTask 是 一 个 抽象 类 ， 所 
以 如 果 我 们 想 使 用 它 ， 就 必须 要 创建 一 个 子 类 去 继承 它 。 在 继承 时 我 们 
可 以 为 AsyncTask 类 指定 3 个 泛 型 参数 ， 这 3 个 参数 的 用 途 如 下 。 





在 执行 AsyncTask 时 需要 传 入 的 参数 ， 可 用 于 在 后 台 任 务 


Progress。 后 台 任 务 执行 时 ， 如 果 需 要 在 界面 上 显示 当前 的 进度 ， 
则 使 用 这 里 指定 的 泛 型 作为 进度 单位 。 


Result。 当 任务 执行 完毕 后 ， 如 果 需 要 对 结果 进行 返回 ， 则 使 用 这 
里 指定 的 泛 型 作为 返回 值 类 型 。 
因此 ， 一 个 最 简单 的 自 定义 AsyncTask 就 可 以 写成 如 下 方式 : 


class DownloadTask extends AsyncTask<Void, Integer, Boolean> { 


} 








这 里 我 们 把 AsyncTask 的 第 一 个 泛 型 参数 指定 为 void， 表 示 在 执行 
AsyncTask 的 时 候 不 需要 传 入 参数 给 后 台 任 务 。 第 二 个 泛 型 参数 指定 
为 Integer， 表 示 使 用 整 型 数据 来 作为 进度 显示 单位 。 第 三 个 泛 型 参数 
指定 为 Boolean， 则 表示 使 用 布尔 型 数据 来 反馈 执行 结果 。 


当然 ， 目 前 我 们 自 定义 的 DownloadTask 还 是 一 个 空 任务 ， 并 不 能 进行 任 
何 实际 的 操作 ， 我 们 还 需要 去 重 写 AsyncTask 中 的 几 个 方法 才能 完成 对 
任务 的 定制 。 经 常 需要 去 重 写 的 方法 有 以 下 4 个 。 





因此 


。OnPreExecute() 





这 个 方法 会 在 后 台 任 务 开始 执行 之 前 调用 ， 用 于 进行 一 些 界面 上 的 
初始 化 操作 ， 比 如 显示 一 个 进度 条 对 话 框 等 。 


. doInBackground(Params...) 








这 个 方法 中 的 所 有 代码 都 会 在 子 线程 中 运行 ， 我 们 应 该 在 这 里 去 处 
理 所 有 的 耗 时 任务 。 任 务 一 旦 完成 束 可 以 通过 return 语 句 来 将 任务 
的 执行 结果 人 返回， 如果 AsyncTask 的 第 三 个 泛 型 参数 指定 的 

是 void， 就 可 以 不 返回 任务 执行 结果 。 注 意 ， 在 这 个 方法 中 是 不 可 
以 进行 UI 操作 的 ， 如 果 需 要 更 新 UI 元 素 ， 比 如 说 反馈 当前 任务 的 执 
行进 度 ， 可 以 调用 publishProgress (Progress.,..) 方 法 来 完成 。 





. OnProgressUpdate(Progress...) 


当 在 后 台 任 务 中 调用 了 publishProgress(Progress...) 方 法 

后 ， onProgressUpdate (Progress...) 方 法 束 会 很 快 被 调用 ， 该 方 
法 中 携 帝 的 参数 就 是 在 后 台 任 务 中 传递 过 来 的 。 在 这 个 方法 中 可 以 
对 UI 进 行 操作 ， 利 用 参数 中 的 数值 就 可 以 对 界面 元 素 进 行 相应 的 更 
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. ONnPostExecute(Result) 





当 后 台 任 务 执行 完毕 并 通过 return 语 句 进 行 返回 时 ， 这 个 方法 就 很 
快 会 被 调用 。 返 回 的 数据 会 作为 参数 传递 到 此 方法 中 ， 可 以 利用 返 
回 的 数据 来 进行 一 些 UI 操作 ， 比 如 说 提醒 任务 执行 的 结果 ， 以 及 关 
闭 掉 进度 条 对 话 框 等 。 


， 一 个 比较 完整 的 自 定 义 AsyncTask 就 可 以 写成 如 下 方式 : 


class DownloadTask extends AsyncTask<Void, Integer, Boolean> { 


Override 
protected Boolean doInBackground(Void... params) { 


rue) { 
int downloadPercent = doDownload(); // 这 是 一 个 虚构 的 方法 
publishProgress(downloadPercent); 
if (downloadPercent >= 100) { 

break; 


} catch (Exception e) { 
return false; 


eturn true; 


erride 
protected void onProgressUpdate(Integer... values) { 

// 在 这 里 更 新 下 载 进度 

progressDialog.setMessage("Downloaded " + Values[9] + "%"); 


verride 
protected void onPostExecute(Boolean result) 
progressDialog.dismiss(); // 关闭 进度 对 话 框 
// 在 这 里 提示 下 载 结果 
if (result) { 
Toast.makeText(context, "Download succeeded", Toast.LENGTH_SHORT).show(); 


{ 


se 
Toast.makeText(context, " Download failed", Toast.LENGTH_SHORT).show(); 


在 这 个 DownloadTask 中 ， 我 们 在 doInBackground() 方 法 里 去 执行 具体 的 
下 载 任务 。 这 个 方法 里 的 代码 都 是 在 子 线程 中 运行 的 ， 因 而 不 会 影响 到 
主线 程 的 运行 。 注 意 这 里 虚构 了 一 个 dopownload() 方 法 ， 这 个 方法 用 于 
计算 当前 的 下 载 进度 并 返回 ， 我 们 假设 这 个 方法 已 经 存在 了 。 在 得 到 了 
当前 的 下 载 进度 后 ， 下 面 束 该 考虑 如 何 把 它 显 示 到 界面 上 了 ， 由 于 
doInBackground() 方 法 是 在 子 线程 中 运行 的 ， 在 这 里 肯定 不 能 进行 UI 操 
作 ， 所 以 我 们 可 以 调用 publishProgress() 方 法 并 将 当前 的 下 载 进度 传 进 
来 ， 这 样 onProgressupdate() 方 法 就 会 很 快 被 调用 ， 在 这 里 就 可 以 进行 
UI 操作 了 。 

当下 载 完成 后 ， doInBackground() 方 法 会 返回 一 个 布尔 型 变量 ， 这 

样 onpostExecute() 方 法 就 会 很 快 被 调用 ， 这 个 方法 也 是 在 主线 程 中 运行 
的 。 然 后 在 这 里 我 们 会 根据 下 载 的 结果 来 弹出 相应 的 Toast 提 示 ， 从 而 
完成 整个 DownloadTask 任 务 。 


简单 来 说 ， 使 用 AsyncTask 的 诀 罕 束 是 ， 在 doInBackground() 方 法 中 执行 
具体 的 耗 时 任务 ， 在 onProgressupdate( ) 方 法 中 进行 UI 操 作 ， 
在 onPostExecute() 方 法 中 执行 一 些 任务 的 收尾 工作 。 


如 果 想 要 司 动 这 个 任务 ， 只 再 编写 以 下 代码 即 可 : 


new DownloadTask().execute(); 

















以 上 惑 是 AsyncTask 的 基本 用 法 ， 怎 么 样 ， 是 不 是 感觉 简单 方便 了 许 
多 ? 我们 并 不 需要 去 考虑 什么 异步 消息 处 理 机 制 ， 也 不 需要 专门 使 用 一 
个 Handler 来 发 送 和 接收 消息 ， 只 需要 调用 一 下 publLishProgress() 方 
法 ， 就 可 以 轻松 地 从 子 线程 切换 到 UI 线 程 了 。 





在 本 章 的 最 佳 实践 环节 ， 我 们 会 对 下 载 这 个 功能 进行 完整 的 实现 。 


10.3 ”服务 的 基本 用 法 


了 解 了 Android 多 线程 编程 的 技术 之 后 ， 下 面 就 让 我 们 进入 到 本 章 的 正 
题 ， 开 始 对 服务 的 相关 内 容 进行 学 习 。 作 为 Android 四 大 组 件 之 一 ， 服 
务 世 少 不 了 有 很 多 非常 重要 的 知识 点 ， 屠 我 们 自然 要 从 最 基本 的 用 法 开 
68 学习 了 。 


10.3.1 定义 一 个 服务 
首先 看 一 下 如 何在 项 目 中 定义 一 个 服务 。 新 建 一 个 ServiceTest 项 目 ， 然 


后 右 击 com.example.servicetest New -Service > Service， 会 弹出 如 图 
10.5 所 示 的 窗口 。 





TT 


Configure Component 


Android Studio 


Creates a new service component and adds it to your Android manifest. 
Exported 


Enabled 
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图 10.5 创建 服务 的 窗口 

可 以 看 到 ， 这 里 我 们 将 服务 命名 为 MyService，Exported 属 性 表示 是 人 否 
允许 除了 当前 程序 之 外 的 其 他 程序 访问 这 个 服务 ，Enabled 属 性 表示 是 
否 启 用 这 个 服务 。 将 两 个 属性 都 勾 中 ， 点 击 Finish 完 成 创建 。 


现在 观察 MyService 中 的 代码 ， 如 下 所 示 : 


public class MyService extends Service { 





public MyService() { 
} 


@Override 
public IBinder onBind(Intent intent 
throw new UnsupportedoperationException("Not yet implemented"); 


} 


可 以 看 到 ，Myservice 是 继承 上 自 service 类 的 ， 说 明 这 是 一 个 服务 。 目 
前 Myservice 中 可 以 算是 空空 如 也 ， 但 有 一 个 onBind() 方 法 特别 醒目 。 这 
个 方法 是 Service 中 唯一 的 一 个 抽象 方法 ， 所 以 必须 要 在 子 类 里 实现 。 我 
们 会 在 后 面 的 小 节 中 使 用 到 onBind() 方 法 ， 目 前 可 以 暂时 将 它 急 略 掉 。 


既然 是 定义 一 个 服务 ， 自 然 应 该 在 服务 中 去 处 理 一 些 事情 了 ， 那 处 理事 
情 的 逻辑 应 该 写 在 哪里 呢 ? 这 时 束 可 以 重 写 Service 中 的 另外 一 些 方 法 
了 ， 如 下 所 未 : 





public cl MyS， ce extends Service { 

Q@overrid 

public void onCreate() { 
super .onCreate( ); 

} 

@override 

public int onStartCommand(Intent intent, int flags, int startId) { 
return super.onSstartCommand(intent, flags, startId); 


可 以 看 到 ， 这 里 我 们 又 重 写 了 oncreate()、onStartcommand() 和 和 

onDestroy() 这 3 个 方法 ， 它 们 是 每 个 服务 中 最 常用 到 的 3 个 方法 了 。 其 
中 oncreate( ) 方 法 会 在 服务 创建 的 时 候 调用 ， OnStartCommand( ) 方 法 会 
人 动 的 时 候 调 用 ，onpestroy() 方 法 会 在 服务 销毁 的 时 候 调 


通常 情况 下 ， 如 果 我 们 希望 服务 一 旦 启动 束 立 刻 去 执行 某 个 动作 ， 束 可 
以 将 逻辑 写 在 onstartcommand() 方 法 里 。 而 当 服 务 销毁 时 ， 我 们 又 应 该 
在 onDestroy() 方 法 中 去 回收 那些 不 再 使 用 的 资源 。 


男 外 需要 注意 ， 每 一 个 服务 都 需要 在 AndroidManifest.xml 文 件 中 进行 注 
册 才 能 生效 ， 不 知道 你 有 没有 发 现 ， 这 是 Android 四 大 组 件 共 有 的 特 

点 。 不 过 相信 你 已 经 猜 到 了 ， 智 能 的 Android Studio 早 已 目 动 帮 有 我 们 将 这 
一 步 完 成 了 。 打 开 AndroidManifest.xml 文 件 瞧 一 瞧 ， 代 码 如 下 所 示 ; 











manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.servicetest"> 


icati 

android:allowBackup="t 
android:icon="@mi 党 h 
android:label="@st g/app_ 
android:supportsRtl="true 
android:theme="@style/AppTheme"> 


<service 
android:name=".MyService" 
android:enabled="true" 
android:exported="true"> 
</service> 
</application> 


</manifest> 


这 样 的 话 ， 就 已 经 将 一 个 服务 完全 定义 好 了 。 
10.3.2 ”启动 和 停止 服务 


定义 好 了 服务 之 后 ， 接 下 来 就 应 该 考虑 如 何 去 启 动 以 及 停止 这 个 服务 。 
局 动 和 停止 的 方法 当然 你 也 不 会 陌生 ， 主 要 是 借助 Intent 来 实现 的 ， 下 
面 就 让 我 们 在 ServiceTest 项 目 中 答 试 去 局 动 以 及 停止 MyService 这 个 服 
务 。 


首先 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 








<Button 
android:id="@+id/start_service" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Start Service" /> 


<Button 
android:id="@+id/stop_service" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Stop Service" /> 


</LinearLayout> 





0 局 文件 中 加 入 了 两 个 按钮 ， 分 别 是 用 于 局 动 服务 和 停止 服 


然后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


@override 

protected void onCreate(Bundle savedInstanceState) { 
super .oncCreate(SavedInstanceState) 
setContentView(R.1layout.activity_main); 
Button startService = (Button) findViewById(R.id.start_ service); 
Button stopService = (Button) findViewById(R.id.stop_service); 
startService.setonClickListener(this); 
stopService.setonclickListener(this); 


} 


@override 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.start_service: 
Intent startIintent = new Intent(this, MyService.class); 
startService(startIntent); // 启动 服务 
break; 


case R.id.stop_service: 
Intent stopIntent = new Intent(this, MyService.class); 
stopService(stopIntent); // 停止 服务 


可 以 看 到 ， 这 里 在 oncreate() 方 法 中 分 别 获取 到 了 Start ”Service 按 钮 和 
Stop Service 按 钮 的 实例 ， 并 给 它们 注册 了 点 击 事件 。 然 后 在 Start 
Service 按 钮 的 点 击 事 件 里 ， 我 们 构建 出 了 一 个 Intent 对 象 ， 并 调 

用 startservice() 方 法 来 启动 MyService 这 个 服务 。 在 Stop Serivce 按 钮 的 
点 击 事件 里 ， 我 们 同样 构建 出 了 一 个 Intent 对 象 ， 并 调用 stopservice() 
方法 来 停止 MyService 这 个 服务 。 startService() 和 stopService() 方 法 
都 是 定义 在 context 类 中 的 ， 所 以 我 们 在 活动 里 可 以 直接 调用 这 两 个 方 
法 。 注 意 ， 这 里 完全 是 由 活动 来 决定 服务 何 时 停止 的 ， 如 果 没 有 点 击 
Stop Service 按 钮 ， 服 务 就 会 一 直人 处 于 运行 状态 。 那 服务 有 没有 什么 办 法 
让 目 己 停止 下 来 呢 ? 当然 可 以 ， 只 需要 在 MyService 的 任何 一 个 位 置 调 
用 stopselLf( ) 方 法 就 能 让 这 个 服务 停止 下 来 了 o 


那么 接 下 来 又 有 一 个 问题 需要 思考 了 ， 我 们 如 何 才能 证 实 服务 已 经 成 功 
启动 或 者 停止 了 呢 ? 最 简单 的 方法 就 是 在 MyService 的 几 个 方法 中 加 入 
打印 日 志 ， 如 下 所 示 : 


public class MyService extends Service { 














@Ooverride 
public void onCreate() { 
super .onCreate( ); 


Log.d("MyService", "onCreate executed"); 

@override 

public int onStartCommand(Intent intent, int flags, int startId) { 
Log.d("MyService", "onStartCommand executed"); 
return super.onStartCommand(intent, flags, startId); 

} 

@Ooverride 


public void onDestroy() { 
super .onDestroy(); 
Log.d("MyService", "onDestroy executed"); 








现在 可 以 运行 一 下 程序 来 进行 测试 了 ， 程 序 的 主 界 面 如 图 10.6 所 示 。 
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ServiceTest 


START SERVICE 


STOP SERVICE 








图 10.6 ”ServiceTest 的 主 界面 
点 击 一 下 Start Service 按 钮 ， 观 察 logcat 中 的 打印 日 志 ， 如 图 10.7 所 示 。 
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com. example. servicetest D/MyService: onCreate executed 








com. example. servicetest D/MyService: onStartCommand executed 


图 10.7 启动 服务 时 的 打印 日 志 


MyService 中 的 oncreate() 和 onstartcommand() 方 法 都 执行 了 ， 说 明 这 个 
服务 确实 已 经 启动 成 功 了 ， 并 且 你 还 可 以 在 Settings - Developer 


options ~ Running services 中 找到 它 ， 如 图 10.8 所 示 。 
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图 10.8 正在 运行 的 服务 列表 


然后 再 点 击 一 下 Stop ” Service 按钮 ， 观 察 logcat 中 的 打印 日 志 ， 如 图 10.9 
所 示 。 
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com. example. servicetest D/MyService: onDestroy executed 





由 此 证 明 ，MyService 确 实 已 经 成 功 停止 下 来 了 。 





话说 回来 ， 虽 然 我 们 已 经 学 会 了 局 动 服务 以 及 停止 服务 的 方法 ， 不 知道 
你 心里 现在 有 没有 一 个 疑惑 ， 那 束 是 oncreate( ) 方 法 和 
onstartcommand() 方 法 到 底 有 什么 区 别 呢 ?” 因 为 刚刚 点 击 Start Service 按 
钮 后 两 个 方法 都 执行 了 。 


其 实 oncreate() 方 法 是 在 服务 第 一 次 创建 的 时 候 调 用 的 ， 

而 onstartcommand() 方 法 则 在 每 次 启动 服务 的 时 候 都 会 调用 ， 由 于 刚才 
我 们 是 第 一 次 点 击 Start Service 按 钮 ， 服 务 此 时 还 未 创建 过 ， 所 以 两 个 方 
法 都 会 执行 ， 之 后 如 果 你 再 连续 多 点 击 几 次 Start Service 按 钮 ， 你 束 会 发 
现 只 有 onstartcommand() 方 法 可 以 得 到 执行 了 。 


10.3.3 ”活动 和 服务 进行 通信 


上 一 小 节 中 我 们 学 习 了 局 动 和 停止 服务 的 方法 ， 不 知道 你 有 没有 发 现 ， 
虽然 服务 是 在 活动 里 局 动 鸭 ， 但 在 局 动 了 服务 之 后 ， 活 动 与 服务 基本 就 
没有 什么 关系 了 。 确 实 如 此 ， 我 们 在 活动 里 调用 了 startservice() 方 法 
来 启动 MyService 这 个 服务 ， 然 后 MyService 的 oncreate() 和 
onstartcommand() 方 法 就 会 得 到 执行 。 之 后 服务 会 一 直 处 于 运行 状态 ， 
但 具体 运行 的 是 什么 逻辑 ， 活 动 束 控制 不 了 了 。 这 就 类 似 于 活动 通知 了 
服务 一 下 :“ 你 可 以 启动 了 ! ”然后 服务 就 去 忙 自 己 的 事情 了 ， 但 活动 并 
不 知道 服务 到 底 去 做 了 什么 事情 ， 以 及 完成 得 如 何 。 


那么 有 没有 什么 办 法 能 让 活动 和 服务 的 关系 更 紧密 一 些 呢 ? 例如 在 活动 
中 指挥 服务 去 干什么 ， 服 务 就 去 干什么 。 当 然 可 以 ， 这 就 需要 借助 我 们 
刚刚 忽略 的 onBind() 方 法 了 。 


比如 说 ， 目 前 我 们 希望 在 MyService 里 提供 一 个 下 载 功 能 ， 然 后 在 活动 
中 可 以 决定 何 时 开始 下 载 ， 以 及 随时 查看 下 载 进度 。 实 现 这 个 功能 的 思 
路 是 创建 一 个 专门 的 Binder 对 象 来 对 下 载 功 能 进行 管理 ， 修 改 
MyService 中 的 代码 ， 如 下 所 示 : 


public class MyService extends Service { 




















private DownloadBinder mBinder = new DownloadBinder(); 
class DownloadBinder extends Binder { 


publ void startDownload() { 
ice", "st 


ic 
Log.d("MySeryv artDownload executed"); 


public int getProgress() { 
Log.d("MyService", "getProgress executed"); 
return 0; 


public IBinder onBind(Intent intent) { 
return mBinder; 
} 


可 以 看 到 ， 这 里 我 们 新 建 了 一 个 pownloadBinder 类 ， 并 让 它 继承 自 
Binder， 然 后 在 它 的 内 部 提供 了 开始 下 载 以 及 查看 下 载 进 度 的 方法 。 当 
然 这 只 是 两 个 模拟 方法 ， 并 没有 实现 真正 的 功能 ， 我 们 在 这 两 个 方法 中 
分 别 打印 了 一 行 日 志 。 


接着 ， 在 MyService 中 创建 了 DownloadBinder 的 实例 ， 然 后 在 onBind( ) 方 
法 里 返回 了 这 个 实例 ， 这 样 MyService 中 的 工作 就 全 部 完成 了 。 


下 面 就 要 看 一 看 ， 在 活动 中 如 何 去 调 用 服务 里 的 这 些 方法 了 。 首 先 需 要 
在 布局 文件 里 新 增 两 个 按钮 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 
人 外: 





<LinearLayout xmlns: android= et //schemas.android.com/apk/res/android" 
android:orientation="verti 
android:layout_width= rt Sone 
android:layout_height="match_parent"> 


<Button 
android:id="@+id/bind_service" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Bind Service" /> 
<Button 
android:id="@+id/unbind_service" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Unbind Service" /> 


</LinearLayout> 


这 两 个 按钮 分 别 是 用 于 绑 定 服务 和 取消 绑 定 服务 的 ， 那 到 底 谁 需要 去 和 
服务 绑 定 呢 ?” 当 然 束 是 活动 了 。 当 一 个 活动 和 服务 绑 定 了 之 后 ， 束 可 以 
调用 该 服务 里 的 Binder 提 供 的 方法 了 了。 修改 MainActivity 中 的 代码 ， 如 
下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 
private MyService.DownloadBinder downloadBinder; 
private ServiceConnection connection = new ServiceConnection() { 


@Override 
public void onServiceDisconnected(ComponentName name) { 


@override 

public void onServiceConnected(ComponentName name, IBinder service) { 
downloadBinder = (MyService.DownloadBinder) service; 
downloadBinder .startDownJload( ) ; 
downloadBinder .getProgress(); 


} 


}; 


@override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceSstate); 
setContentView(R.1layout.activity_main); 


Button bindService = (Button) findViewById(R.id.bind_service); 
Button unbindService = (Button) findViewById(R.id.unbind_service); 
bindSservice.setonclickListener(this); 
unbindService.setOonClickListener(this); 


} 


@override 
public void onClick(View v) { 
switch vagetrd)y 契 


case R.id.bind_ service: 
Intent bindIntent = new Intent(this, MyService.class); 
te en connection，BIND_AUTO_CREATE); // 绑 定 服务 


SEE Re id ' unbind_service: 
unbindService(connection); // 解 绑 服 务 


这 里 我 们 首先 创建 了 一 个 serviceconnection 的 匿名 类 ， 在 里 面 重 写 了 
onServiceConnected( ) 方 法 和 onserviceDisconnected( 7 这 两 个 方 
法 分 别 会 在 活动 与 服务 成 功 绑 定 以 及 活动 与 服务 的 连接 断 开 的 时 候 调 
用 。 在 onserviceconnected() 方 法 中 ， 我 们 又 通过 向 下 转型 得 到 了 
DownloadBinder 的 实例 ， 有 了 这 个 实例 ， 活 动 和 服务 之 间 的 关系 束 变 得 
非常 紧密 了 。 现 在 我 们 可 以 在 活动 中 根据 具体 的 场景 来 调 

用 DownloadBinder 中 的 任何 public 方 法 ， 即 实现 了 指挥 服务 干什么 服务 
就 去 干什么 的 功能 。 这 里 仍然 只 是 做 了 个 简单 的 测试 ， 

在 onserviceconnected() 方 法 中 调用 了 DownloadBinder 的 
startDownload( ) 和 和 getProgress() 方 法 。 


当然 ， 现 在 活动 和 服务 其 实 还 没 进行 绑 定 呢 ， 这 个 功能 是 在 Bind Service 
Ra eh 可 以 看 到 ， 这 里 我 们 仍然 是 构建 出 了 一 

个 Intent 对 象 ， 然 后 调用 bindService( ) 方 法 将 MainActivity 和 MyService 
进行 绑 定 。 bindservice() 广 法 所 3 个 全数 ， 第 一 个 参数 就 是 刚刚 构建 
出 的 Intent 对 象 ， 第 二 个 参数 是 前 面 创 建 出 的 ServiceConnection 的 实 

例 ， 第 个 参数 则 是 一 个 标志 位 ， 这 里 传 入 BIND_AUTO_CREATE 表 示 在 活 
动 和 服务 进行 绑 定 后 自动 创建 服务 。 这 会 使 得 MyService 中 的 oncreate() 
方法 得 到 执行 ， 但 onstartcommand( ) 方 法 不 会 执行 。 


然后 如 果 我 们 想 解 除 活 动 和 服务 之 间 的 绑 定 该 怎么 办 呢 ? 调用 一 
下 unbindservice() 方 法 束 可 以 了 ， 这 也 是 Unbind Service 按 钮 的 点 击 事 
件 里 实现 的 功能 。 


现在 让 我 们 重新 运行 一 下 程序 吧 ， 界 面 如 图 10.10 所 示 。 
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ServiceTest 


START SERVICE 


STOP SERVICE 


BIND SERVICE 


UNBIND SERVICE 








图 10.10 ”ServiceTest 新 的 主 界面 


反击 一 下 Bind Service 按 钮 ， 然 后 观察 logcat 中 的 打印 日 志 ， 如 图 10.11 所 
示 。 
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com. example. servicetest D/MyService: onCreate executed 





com. example. servicetest D/MyService: startDownload executed 


com. example. servicetest D/MyService: getProgress executed 


图 10.11 绑 定 服务 时 的 打印 日 志 


可 以 看 到 ， 首 先是 MyService 的 oncreate() 方 法 得 到 了 执行 ， 然 
后 startDownload() 和 getpProgress() 方 法 都 得 到 了 执行 ， 说 明 我 们 确实 
已 经 在 活动 里 成 功 调用 了 服务 里 提供 的 方法 了 。 


另外 需要 注意 ， 任 何 一 个 服务 在 整个 应 用 程序 范围 内 都 是 通用 的 ， 即 
MyService 不 仅 可 以 和 MainActivity 绑 定 ， 还 可 以 和 任何 一 个 其 他 的 活动 
进行 绑 定 ， 而 且 在 绑 定 完成 后 它们 都 可 以 获取 到 相同 的 DownloadBinder 
实例 。 








10.4 ”服务 的 生命 周期 


之 前 我 们 学 习 过 了 活动 以 及 碎片 的 生命 周期 。 类 似 地 ， 服 务 也 有 自己 的 
生命 周期 ， 前 面 我 们 使 用 到 的 
onCreate()、 onStartCommand()、 onBind( ) 和 onDestroy( ) 等 方法 都 是 在 


服务 的 生命 周期 内 可 能 回调 的 方法 。 


一 旦 在 项 目的 任何 位 置 调用 了 Context 的 startService( jy27 相应 的 服 
务 就 会 启动 起 来 ， 并 回调 onstartcommand() 方 法 。 如 果 这 个 服务 之 前 还 
没有 创建 过 ，oncreate( ) 方 法 会 先 于 onstartcommand() 方 法 执行 。 服 务 
启动 了 之 后 会 一 直 保 持 运 行 状 态 ， 直 到 stopservice() 或 stopself() 方 法 
被 调用 。 注 意 ， 虽 然 每 调用 一 次 startservice() 方 

法 ，onstartcommand() 就 会 执行 一 次 ， 但 实际 上 每 个 服务 都 只 会 存在 一 
个 实例 。 所 以 不 管 你 调用 了 多 少 次 startservice() 方 法 ， 只 需 调用 一 
次 stopService() 或 stopSelLf() 方 法 ， 服 务 就 会 停止 下 来 了 。 


另外 ， 还 可 以 调用 Context 的 bindservice() 来 获取 一 个 服务 的 持久 连 
接 ， 这 时 就 会 回调 服务 中 的 onBind() 方 法 。 类 似 地 ， 如 果 这 个 服务 之 前 
还 没有 创建 过 ，oncreate() 方 法 会 先 于 onBind() 方 法 执行 。 之 后 ， 调 用 
方 可 以 获取 到 onBind() 方 法 里 返回 的 IBinder 对 象 的 实例 ， 这 样 就 能 自由 
地 和 服务 进行 通信 了 。 只 要 调用 方 和 服务 之 间 的 连接 没有 断 开 ， 服 务 束 
会 一 直 保 持 运 行 状 态 。 


当 调 用 了 startservice() 方 法 后 ， 义 去 调用 stopservice() 方 法 ， 这 时 服 
务 中 的 onpestroy() 方 法 驶 会 执行 ， 表 示 服 务 已 经 销毁 了 。 类 似 地 ， 当 
调用 了 bindservice() 方 法 后 ， 又 去 调用 unbindservice() 方 

法 ，onDestroy() 方 法 也 会 执行 ， 这 两 种 情况 都 很 好 理解 。 但 是 需要 注 
意 ， 我 们 是 完全 有 可 能 对 一 个 服务 既 调 用 了 startservice() 方 法 ， 叉 调 
用 了 bindservice() 方 法 的 ， 这 种 情况 下 该 如 何 才 能 让 服务 销毁 摊 呢 ? 
根据 Android 系 统 的 机 制 ， 一 个 服务 只 要 被 局 动 或 者 被 绑 定 了 之 后 ， 束 
会 一 直人 处 于 运行 状态 ， 必 须要 让 以 上 两 种 条 件 同 时 不 满足 ， 服 务 才 能 被 
销毁 。 所 以 ， 这 种 情况 下 要 同时 调用 stopservice() 和 unbindservice() 
方法 ，onDestroy() 方 法 才 会 执行 。 


这 样 你 惑 已 经 把 服务 的 生命 周期 完整 地 走 了 一 过 。 




















10.5 服务 的 更 多 技巧 


以 上 所 学 的 都 是 关于 服务 最 基本 的 一 些 用 法 和 概念 ， 当 然 也 是 最 第 用 
的 。 不 过 ， 仅 仅 满 足 于 此 显然 是 不 够 的 ， 关 于 服务 的 更 多 高 级 使 用 技巧 
还 在 等 着 我 们 呢 ， 下 面 就 赶快 去 看 一 看 吧 。 


10.5.1 使 用 前 台 服 务 


服务 几乎 都 是 在 后 台 运 行 的 ， 一 直 以 来 它 都 是 默默 地 做 着 辛苦 的 工作 。 
但 是 服务 的 系统 优先 级 还 是 比较 低 的 ， 当 系统 出 现 内 存 不 足 的 情况 时 ， 
就 有 可 能 会 回收 掉 正 在 后 台 运 行 的 服务 。 如 果 你 希望 服务 可 以 一 直 保 持 
运行 状态 ， 而 不 会 由 于 系统 内 存 不 足 的 原因 导致 被 回收 ， 就 可 以 考虑 使 
用 前 台 服 务 。 前 台 服 务 和 普通 服务 最 大 的 区 别 束 在 于 ， 它 会 一 直 有 一 个 
正在 运行 的 图 标 在 系统 的 状态 栏 显示 ， 下 拉 状 态 栏 后 可 以 看 到 更 加 详细 
的 信息 ， 非 第 类 似 于 通知 的 效果 。 当 然 有 时 候 你 也 可 能 不 仅仅 是 为 了 防 
止 服务 被 回收 摊 才 使 用 前 全 服务 的 ， 有 些 项 目 由 于 特殊 的 需求 会 要 求 必 
须 使 用 前 合 服务 ， 比 如 说 彩云 天 气 这 天 天 气 预报 应 用 ， 它 的 服务 在 后 人 台 
1 
10.12 所 未 。 


























未 来 两 小 时 不 会 下 雨 ， 放 心 出 门 吧 





图 10.12 彩云 天 气 的 前 人 台 服 务 效果 


那么 我 们 就 来 看 一 下 如 何 才 能 创建 一 个 前 台 服 务 吧 ， 其 实 并 不 复杂 ， 修 
改 MyService 中 的 代码 ， 如 下 所 示 : 


public class MyService extends Service { 


@Override 
public void onCreate() { 
super .onCreate( ); 
Log.d("MyService", "onCreate executed"); 
Intent intent = new Intent(this, MainActivity.class); 
PendingIntent pi = PendingIntent.getActivity(this, 0, intent, 0); 
Notification notification = new NotificationCompat.Builder(this) 
.SetcontentTitle("This is content title") 
.SetContentText("This is content text") 
.Setwhen(System.currentTimeMillis()) 
.SetsmallIcon(R.mipmap.ic_launcher) 
.SetLargeIcon(BitmapFactory.decodeResource(getResources(), 
R.mipmap.ic_launcher)) 
.SetcontentIintent (pi) 


可 以 看 到 ， 这 里 只 是 修改 了 oncreate() 方 法 中 的 代码 ， 相 信 这 部 分 代码 
你 会 非常 眼熟 。 没 错 ! 这 就 是 我 们 在 第 8 章 中 学 习 的 创建 通知 的 方法 。 
只 不 过 这 次 在 构建 出 Notification 对 象 后 并 没有 使 用 NotificationManager 
来 将 通知 显示 出 来 ， 而 是 调用 了 startForeground() 方 法 。 这 个 方法 接收 
两 个 参数 ， 第 一 个 参数 是 通知 的 id， 人 一 个 参 
数 ， 第 二 个 参数 则 是 构建 出 的 Notification 对 象 。 

用 startForeground() 方 法 后 就 会 人 并 在 
系统 状态 栏 显 示 出 来 。 


现在 重新 运行 一 下 程序 ， 并 点 击 Start ”Service 或 Bind ”Service 按 钮 ， 
MYyService 就 会 以 前 台 服 务 的 模式 启动 了 ， 并 且 在 系统 状态 栏 会 显示 一 
个 通知 图 标 ， 下 拉 状 态 栏 后 可 以 看 到 该 通知 的 详细 内 容 ， 如 图 10.13 所 
2 








各, This is content title 
hiSiS Conmtent text 





图 10.13 ”前 人 台 服 务 的 状态 栏 效果 


前 台 服 务 的 用 法 就 这 么 简单 ， 只 要 你 在 第 8 章 中 将 通知 的 用 法 掌握 好 
了 ， 学 习 本 节 的 知识 一 定 会 特别 轻松 。 

10.5.2 ”使 用 IntentService 

话说 回来 ， 在 本 章 一 开始 的 时 候 我 们 就 已 经 知道 ， 服 务 中 的 代码 都 是 默 
认 运 行 在 主线 程 当 中 的 ， 如 果 直 接 在 服务 里 去 处 理 一 些 耗 时 的 逻辑 ， 就 
很 容易 出 现 ANR (Application Not Responding) 的 情况 。 


所 以 这 个 时 候 就 需要 用 到 Android 多 线程 编程 的 技术 了 ， 我 们 应 该 在 服 
务 的 每 个 具体 的 方法 里 开局 一 个 子 线程 ， 然 后 在 这 里 去 处 理 那 些 耗 时 的 





逻辑 。 因此， 一 个 比较 标准 的 服务 就 可 以 写成 如 下 形式 : 
public class MyService extends Service { 


@override 
public int onStartCommand(Intent intent, int flags, int startId) { 
new Thread(new Runnable() { 
@override 
public void run() { 
// 处 理 具体 的 逻辑 


}).start(); 
return super.onStartCommand(intent, flags, startId); 


} 


但 是 ， 这 种 服务 一 旦 启动 之 后 ， 束 会 一 直 处 于 运行 状态 ， 必 须 调 
用 stopservice() 或 者 stopSself() 方 法 才能 让 服务 停止 下 来 。 所 以 ， 如 果 
想 要 实现 让 一 个 服务 在 执行 完毕 后 自动 停止 的 功能 ， 就 可 以 这 样 写 : 


public class MyService extends Service { 


@Ooverride 
public int onStartCommand(Intent intent, int flags, int startId) { 
new Thread(new Runnable() { 
@override 
public void run() { 
// 处 理 具体 的 逻辑 
stopself(); 


ystartCy: 
return super.onStartCommand(intent, flags, startId); 
} 





虽说 这 种 写法 并 不 复杂 ， 但 是 总 会 有 一 些 程序 员 和 忘记 开启 线程 ， 或 者 访 
记 调 用 stopself() 方 法 。 为 了 可 以 简单 地 创建 一 个 异步 的 、 会 自动 停止 
的 服务 ，Android 专 门 提供 了 一 个 Intentservice 类 ， 这 个 类 就 很 好 地 人 解 
决 了 前 面 所 提 到 的 两 种 尴 价 ， 下 面 我 们 就 来 看 一 下 它 的 用 法 。 


新 建 一 个 MyIntentservice 类 继承 自 Intentservice， 代 人 码 如 下 所 示 : 


public class MyIntentService extends IntentService { 











public MyIntentService() { 
super("MyIntentService"); // 调用 父 类 的 有 参 构造 函数 














@override 
protected void onHandleIntent(Intent intent) { 

// 打印 当前 线程 的 id 

Log.d("MyIntentService", "Thread id is " + Thread.currentThread(). getId()); 


@Override 
public void onDestroy() { 
super .onDestroy(); 
Log.d("MyIntentService", "onDestroy executed"); 


这 里 首先 要 提供 一 个 无 参 的 构造 函数 ， 并 且 必 须 在 其 内 部 调用 父 类 的 有 
参 构 造 函 数 。 然 后 要 在 子 类 中 去 实现 onhandleIntent() 这 个 抽象 方法 ， 
在 这 个 方法 中 可 以 去 处 理 一 些 具 体 的 逻辑 ， 而 且 不 用 担心 ANR 的 问题 ， 
因为 这 个 方法 已 经 是 在 子 线程 中 运行 的 了 。 这 里 为 了 证 实 一 下 ， 我 们 
在 onHandleIntent() 方 法 中 打印 了 当前 线程 的 d。 男 外 根 

据 Intentservice 的 特性 ， 这 个 服务 在 运行 结束 后 应 该 是 会 目 动 停止 

的 ， 所 以 我 们 又 重 写 了 onpestroy() 方 法 ， 在 这 里 也 打印 了 一 行 日 志 ， 
以 证 实 服务 是 不 是 停止 抒 了 。 


接 下 来 修改 activity_main.xml 中 的 代码 ， 加 入 一 个 用 于 启动 
MylIntentService 这 个 服务 的 按钮 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 











<Button 
android:id="@+id/start_intent_service" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Start IntentService" /> 


</LinearLayout> 


然后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity main); 


Button startIintentService = (Button) findViewById(R.id.start_intent_ 
rvice); 
startIintentService.setOnclickListener(this); 


} 


@Override 
public void onClick(View v) { 
Switch (v.getId()) { 


case R.id.start_intent_service: 
// 打印 主线 程 的 id 
Log.d("MainActivity", "Thread id is " + Thread.currentThread(). 
get1Id()); 
Intent intentService = new Intent(this, MyIntentService.class); 
startService(intentService); 





可 以 看 到 ， 我 们 在 Start IntentService 按 钮 的 点 击 事件 里 面 去 局 动 
MyIntentService 这 个 服务 ， 并 在 这 里 打印 了 一 下 主线 程 的 id， 稍 后 用 于 


和 IntentService 进 行 比 对 。 你 会 发 现 ， 其 实 IntentService 的 用 法 和 普通 的 
服务 没什么 两 样 。 


后 不 要 忘记 ， 服 务 都 是 需要 在 AndroidManifest.xml 里 注册 的 ， 如 下 所 





最 
仆 
<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.servicetest"> 
<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 


android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


<service android:name=".MyIntentService" /> 
</application> 


</manifest> 


当然 你 也 可 以 使 用 Android Studio 提 供 的 快捷 方式 来 创建 IntentService， 
不 过 由 于 这 样 会 自动 生成 一 些 我 们 用 不 到 的 代码 ， 因 此 这 里 我 采用 了 手 
动 创 建 的 方式 。 


现在 重新 运行 一 下 程序 ， 界 面 如 图 10.14 所 示 。 
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ServiceTest 


START SERVICE 











STOP SERVICE 


BIND SERVICE 


UNBIND SERVICE 


START INTENTSERVICE 





图 10.14 ServiceTest 更 新 后 的 主 界面 


点 击 Start ”IntentService 按 钮 后 ， 观 察 logcat 中 的 打印 日 志 ， 如 图 10.15 所 
本 





Verbose 图 (Q- ) 





/com. example. servicetest D/MainActivity: Thread id is 1 
com. example. servicetest D/MyIntentService: Thread id is 154 


/com. example. servicetest D/MyIntentService: onDestroy executed 


图 10.15 ”启动 IntentService 时 的 打印 日 志 


可 以 看 到 ， 不 仅 MyIntentService 和 MainActivity 所 在 的 线程 id 不 一 样 ， 而 
且 onpestroy() 方 法 也 得 到 了 执行 ， 说 明 MyIntentService 在 运行 完毕 后 确 
实 上 自动 停止 了 。 集 开局 线程 和 目 动 停止 于 一 身 ，IntentService 还 是 博得 
了 不 少 程序 员 的 喜爱 。 








好 了 ， 关 于 服务 的 知识 点 你 已 经 学 得 够 多 了 ， 下 面 就 让 我 们 进入 到 本 章 
的 最 佳 实践 环节 吧 。 


10.6 服务 的 最 佳 实践 一 一 完整 版 的 
下 载 示例 


本 章 中 你 已 经 掌握 了 很 多 关于 服务 的 使 用 技巧 ， 但 是 当 在 真正 的 项 目 里 
需要 用 到 服务 的 时 候 ， 可 能 还 会 有 一 些 理 手 的 问题 让 你 不 知 所 措 。 因 

此 ， 下 面 我 们 就 来 综合 运用 一 下 ， 尝 试 实现 一 个 在 服务 中 经 常会 使 用 到 
的 功能 下 载 。 

本 节 中 我 们 将 要 编写 一 个 完整 版 的 下 载 示 例 ， 其 中 会 涉及 第 7 章 、 第 8 

革 、 第 9 章 和 第 10 章 的 部 分 内 容 ， 算 是 目前 为 止 综合 程度 最 高 的 一 个 例 
子 了 。 人 准备 好 了 吗 ? 创建 一 个 ServiceBestPractice 项 目 ， 然 后 开始 本 节 的 
学 习 之 请 吧 。 

首先 我 们 需要 将 项 目 中 会 使 用 到 的 依赖 库 添 加 好 ， 编 辑 app/build.gradle 
文件 ， 在 dependencies 闭 包 中 添加 如 下 内 容 : 


dependencies 有 




















Pe Eps’ 4nelUdes L440] 
compile ' .android.support:appcompat-v7:24.2.1' 
testCompile 'junit:junit:4.12" 
compile 'com.squareup.okhttp3:okhttp:3.4.1" 

} 


这 里 只 需 添 加 一 个 OkHttp 的 依赖 就 行 了 ， 待 会 儿 在 编写 网 络 相 关 的 功能 
时 ， 我 们 将 使 用 OkHttp 来 进行 实现 。 


接 下 来 需要 定义 一 个 回调 接口 ， 用 于 对 下 载 过 程 中 的 各 种 状态 进行 监听 
和 回调 。 新 建 一 个 DownloadListener 接 口 ， 代 码 如 下 所 示 : 


public interface DownloadListener { 








nProgress(int progress); 


onsuccess(); 


onPaused(); 


必 过 .这 
口 口 口 口 
EE EE EE EF EF 
= = [= 口 口 
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onFailed() ， 
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onCanceled(); 


可 以 看 到 ， 这 里 我 们 一 共 定 义 了 5 个 回调 方法 ，onProgress() 方 法 用 于 


通知 当前 的 下 载 进度 ，onsuccess() 方 法 用 于 通知 下 载 成 功 事 
件 ，onFailed() 方 法 用 于 通知 下 载 失败 事件 ，onPaused() 方 法 用 于 通知 
下 载 和 暂停 事件 ，oncanceled() 方 法 用 于 通知 下 载 取 消 事件 。 


回调 接口 定义 好 了 之 后 ， 下 面 我 们 就 可 以 开始 编写 下 载 功能 了 。 这 里 我 
准备 使 用 本 章 中 刚 学 的 AsyncTask 来 进行 实现 ， 新 建 一 个 pownloadTask 
继承 自 AsyncTask， 代 码 如 下 所 示 : 


public class DownloadTask extends AsyncTask<String, Integer, Integer> { 


public static final int TYPE_SUCCESS = 0; 
public static final int TYPE_FAILED 
public static final int TYPE_PAUSED 
public static final int TYPE_CANCELED 


private DownloadListener listener; 
private boolean isCanceled = false; 
private boolean isPaused = false; 
private int lastProgress; 


public DownloadTask(DownloadListener listener) { 
this.listener = listener; 
} 


@Override 
protected Integer doInBackground(String... params) { 
InputStream is = null; 
RandomAccessFile savedFile = null; 
File file = null; 
try { 
long downloadedLength = 0; // 记录 已 下 载 的 文件 长 度 
String downloadUrl = params[0]; 
String fileName = downloadUrl1.substring(downloadUrl.1lastIndexof("/")); 
String directory = Environment .getExternalStoragePub1licDirectory 
(Environment .DIRECTORY_DOWNLOADS ) .getPath( ) ， 
file = new File(directory + fileName); 
if (file.exists()) { 
downloadedLength = file.length(); 
} 


long contentLength = getContentLength(downloadUr1); 
if (contentLength == 0) { 
return TYPE_FAILED; 
} else if (contentLength == downloadedLength) { 
// 已 下 载 字 节 和 文件 总 字 节 相等 ， 说 明 已 经 下 载 完成 了 
return TYPE_SUCCESS 


灿 
OkHttpClient client = new OkHttpClient(); 
Request request = new Request.Builder() 
// 断 点 下 载 ， 指 定 从 哪个 字 节 开始 下 载 
.addHeader ("RANGE", "bytes=" + downloadedLength + "-") 
.Url(downloadUr1) 
.build(); 
Response response = client.newCall(request).execute(); 
if (response != null) { 
is = response.body().bytestream( ); 
savedFile = new RandomAccessFile(file, "rw"); 
savedFile.seek(downloadedLength); // 跳 过 已 下 载 的 字 节 
byte[] b = new byte[1024]; 
nt total sa 
int len; 
while ((len = is.read(b)) != -1) { 
if (isCanceled) { 
return TYPE_CANCELED 
} else if(isPaused) { 
return TYPE_PAUSED; 
} else { 
total += len; 
savedFile.write(b, 0, len); 
// 计算 已 下 载 的 百分比 
int progress = (int) ((total + downloadedLength) * 100 / 
contentLength); 
publishProgress(progress); 
} 
} 
response.body().close(); 
return TYPE_SUCCESS; 


} 
} catch (Exception e) { 
e.printstackTrace(); 
} finally { 


try { 
if (is != null) { 
is.close(); 


} 
if (savedFile != null) { 
savedFile.close(); 


} 
if (isCanceled && file != null) { 
file.delete(); 


} 
} catch (Exception e) { 
e.printSstackTrace(); 


J 
} 
return TYPE_FAILED; 
} 
@Override 
protected void onProgressUpdate(Integer... values) { 
int progress = values[0]; 
if (progress > lastProgress) { 
listener.onProgress(progress); 
lastProgress = progress; 
@override 


protected void onPostExecute(Integer status) { 
switch (status) { 
case TYPE- SUCCESS: 
listener.onSuccess(); 
break; 
case TYPE- FAITLED: 
listener .onFailed(); 
break; 
case TYPE_PAUSED : 
listener.onPaused() ; 
break; 
case TYPE_CANCELED: 
listener.onCanceled(); 
break; 
default: 
break; 
} 


} 


public void pauseDownload() { 
isPaused = true; 
} 


public void cancelDownload() { 
isCanceled = true; 


private long getContentLength(String downloadUr1) throws IOException { 
OkHttpClient client = new OkHttpClient(); 
Request request = new Request.Builder() 
.Url(downloadUr1) 
.build(); 
Response response = client.newCall(request).execute(); 
if (response != null && response.isSuccessful()) { 
long contentLength = response.body().contentLength(); 
response.body().close(); 
return contentLength; 


return 0; 


这 段 代 码 就 比较 长 了 ， 我 们 需要 一 步 步 地 进行 分 析 。 首 先 看 一 下 
AsyncTask 中 的 3 个 泛 型 参数 ; We 0 表示 在 执 
行 AsyncTask 的 时 候 需 要 传 入 一 个 字符 串 参数 给 后 台 任 务 ; 第 二 个 泛 型 
参数 指定 为 Integer， 圾 示 伪 用 整 型 数据 来 作为 进度 显示 单位 第 三 个 
泛 型 参数 指定 为 Integer， 则 表示 使 用 整 型 数据 来 反馈 执行 结 


接 下 来 我 们 定义 了 4 个 整 型 常量 用 于 表示 下 载 的 状态 ，TYPE_sSuccEsSs 表 
示 下 载 成 功 ，TYPE_FAILED 表 示 下 载 失 败 ， a 











载 ，TYPE_CANCELED 表 示 取 消 下 载 。 然 后 在 pownloadTask 的 构造 函数 中 要 
求 传 入 一 个 刚刚 定义 的 pownloadListener 参 数 ， 我 们 竺 会 就 会 将 下 载 的 
状态 通过 这 个 参数 进行 回调 。 





接着 就 是 要 重 写 doInBackground()、onProgressUpdate() 和 
onPostExecute( ) 这 3 个 方法 了 ， 我 们 之 前 已 经 学 习 过 这 3 个 方法 各 目的 作 
用 ， 因 此 在 这 里 它们 各 自 所 负责 的 任务 也 是 明确 的 : doInBackground() 
方法 用 于 在 后 台 执 行 具体 的 下 载 逻 辑 ，onpProgressuUpdate() 方 法 用 于 在 
0 





那么 先 来 看 一 下 doInBackground() 方 法 ， 首 先 我 们 从 参数 中 获取 到 了 下 
载 的 URL 地 址 ， 并 根据 URL 地 址 解析 出 了 下 载 的 文件 名 ， 然 后 指定 将 文 
件 下 载 到 Environment.DIRECTORY _DOWNLOADS 目 录 下 ， 也 就 是 SD 
卡 的 Download 目 录 。 我 们 还 要 判断 一 下 Download 目 录 中 是 不 是 已 经 存 
在 要 下 载 的 文件 了 ， 如 果 已 经 存在 的 话 则 读 取 已 下 载 的 字 节 数 ， 这 样 就 
可 以 在 后 面 启 用 断 点 续 传 的 功能 。 接 下 来 先是 调用 了 
getcontentLength() 方 法 来 获取 竺 下 载 文件 的 总 长 度 ， 如 果 文 件 长 度 等 
于 0 则 说 明文 件 有 问题 ， 直 接 返回 TYPE_FAILED， 如 果 文 件 长 度 等 于 已 下 
载 文 件 长 度 ， 那 么 就 说 明文 件 已 经 下 载 完 了 ， 直 接 返 回 TYPE_SsuccESss 即 
可 。 紧 接着 使 用 OkHttp 来 发 送 一 条 网 络 请 求 ， 需 要 注意 的 是 ， 这 里 在 请 
求 中 添加 了 一 个 header， 用 于 告诉 服务 器 我 们 想 要 从 哪个 字 节 开始 下 
栽 ， 因 为 已 下 载 过 的 部 分 就 不 需要 再 重新 下 载 了 。 接 下 来 读 取 服务 器 啊 
应 的 数据 ， 并 使 用 Java 的 文件 流 方 式 ， 不 断 从 网 络 上 读 取 数据 ， 不 断 写 
入 到 本 地 ， 一 直到 文件 全 部 下 载 完 成 为 止 。 在 这 个 过 程 中 ， 我 们 还 要 判 
断 用 户 有 没有 触发 暂停 或 者 取消 的 操作 ， 如 果 有 的 话 则 返回 
TYPE_PAUSED 或 TYPE_CANCELED 来 中 断 下 载 ， 如 果 没 有 的 话 则 实时 计算 当 
前 的 下 载 进 度 ， 然 后 调用 publishProgress() 方 法 进行 通知 。 和 暂停 和 取消 
操作 都 是 使 用 一 个 布尔 型 的 变量 来 进行 控制 的 ， 调 用 pauseDownload() 
或 cancelDownload() 方 法 即 可 更 改变 量 的 值 。 


接 下 来 看 一 下 onProgressUpdate() 方 法 ， 这 个 方法 束 人 简单 得 多 了 ， 它 肯 
先 从 参数 中 获取 到 当前 的 下 载 进 度 ， 然 后 和 上 一 次 的 下 载 进 度 进行 对 
比 ， 如 果 有 变化 的 话 则 调用 DownloadListener 的 onProgress() 方 法 来 通知 
下 载 进 度 更 新 。 


最 后 是 onPostExecute() 方 法 ， 也 非常 简单 ， 束 是 根据 参数 中 传 入 的 下 载 
状态 来 进行 回调 。 下 载 成 功 就 调用 DownloadListener 的 onsuccess() 方 























法 ， 下 载 失 败 就 调用 onFailed() 方 法 ， 和 暂停 下 载 就 调用 onPaused() 方 
法 ， 取 消 下 载 就 调用 oncanceled() 方 法 。 


这 样 我 们 就 把 具体 的 下 载 功 能 完成 了 ， 下 面 为 了 保证 DownloadTask 可 以 
一 直 在 后 台 运 行 ， 我 们 还 需要 创建 一 个 下 载 的 服务 。 右 击 
com.example.servicebestpractice New ~ Service ~ Service， 新 建 


DownloadService， 然 后 修改 其 中 的 代码 ， 如 下 所 示 : 


public class DownloadService extends Service { 





private DownloadTask downloadTask; 
private String downloadUrl; 


private DownloadListener listener = new DownloadListener() { 
@Override 
public void onProgress(int progress) { 
getNotificationManager().notify(1, getNotification("Downloading...", 
progress)); 


} 


@Override 
public void onSuccess() { 
downloadTask = null; 
// 下 载 成 功 时 将 前 台 服 务 通知 关闭 ， 并 创建 一 个 下 载 成 功 的 通知 
stopForeground(true); 
getNotificationManager().notify(1, getNotification("Download Success", 
-1)); 
Toast.makeText (DownloadService.this, "Download Success", 
Toast .LENGTH_SHORT) .show() ; 





} 


@Override 
public void onFailed() { 
downloadTask = null; 
// 下 载 失败 时 将 前 台 服务 通知 关闭 ， 并 创建 一 个 下 载 失 败 的 通知 
stopForeground(true); 
getNotificationManager().notify(1, getNotification("Download Failed", 
-1)); 
Toast.makeText (DownloadService.this, "Download Failed", 
Toast .LENGTH_SHORT) .show() ; 


} 


@Override 
public void onPaused() { 
downloadTask = null; 
Toast.makeText (DownloadService.this, "Paused", Toast .LENGTH_SHORT). 
show( ); 


} 


@Override 
public void onCanceled() { 
downloadTask = null; 
stopForeground(true); 
Toast .makeText (DownloadService.this, "Canceled", Toast.LENGTH_SHORT). 
show( ); 


}; 
private DownloadBinder mBinder = new DownloadBinder(); 


@override 

public IBinder onBind(Intent intent) { 
return mBinder; 

} 


class DownloadBinder extends Binder { 


public void startDownload(String url) { 
if (downloadTask == null) { 
downloadUrl = url; 
downloadTask = new DownloadTask(listener); 
downloadTask .execute(downloadUr1); 
startForeground(1, getNotification("Downloading...", 0)); 
Toast.makeText (DownloadService.this, "Downloading...", Toast. 
LENGTH_SHORT) .show( ); 


} 


public void pauseDownload() { 
if (downloadTask != null) { 
downloadTask .pauseDownload(); 
D 


} 


public void cancelDownload() { 
if (downloadTask != null) { 
downloadTask.cancelDownload( ); 
} else 
if Foo a != i 
/ 取消 下 载 时 需 将 文人 除 ， 并 将 通知 关闭 
公 fileName = downloadUrl.substring(downloadUr1. 
lastIindexof("/")); 
String directory = Environment.getExternalStoragePublicDirectory 
(Environment .DIRECTORY_DOWNLOADS ) .getPath( ); 
File file = new File(directory + fileName) 
if (file.exists()) { 
file.delete(); 
} 
getNotificationManager().cancel(1); 
stopForeground(true); 
Toast.makeText (DownloadService.this, "Canceled", 
Toast .LENGTH_SHORT). show( ); 


} 
} 


} 


private NotificationManager getNotificationManager() { 
return (NotificationManager) getSystemService(NOTIFICATION_ SERVICE); 


private Notification getNotification(String title, int progress) { 
Intent intent = new Intent(this, MainActivity.class); 
PendingIntent pi = PendingIntent . getActivity(this; 0, intent, 0); 
NotificationCompat.Builder builder = new oldet on oa Builder(this); 
builder.setSsmallIcon(R.mipmap.ic_launche 
biiilder seti ardeicontBitni ne tery 08EodeRSs5UEESCOeERSSO0ESSS CO 
R.mipmap.ic_launcher)); 
builder.setContentIintent (pi); 
builder. setCcontentTitle(title); 
if (progress > = 0) { 
// 当 progress 大 于 或 等 于 9 时 才 需 显示 下 载 进度 
builder.setContentText(progress + "%" 
builder .setProgress(100, progress, false); 


} 
return builder.build(); 


这 上 段 代 人 码 同样 也 比较 长 ， 我 们 还 是 得 耐心 慢 慢 看 。 首 先 这 里 创建 了 一 
个 DownloadListener 的 匿名 类 实例 ， 并 在 匿名 类 中 实现 了 
onProgress()、onSuccess()、onFailed()、 onPaused( ) 和 oncanceled() 
这 5 个 方法 。 在 onProgress() 方 法 中 ， es 
构建 了 一 个 用 于 显示 下 载 进度 的 通知 ， 然 后 调用 NotificationManager 的 
notify() 方 法 去 触发 这 个 通知 ， 这 样 就 可 以 在 下 拉 状 态 栏 中 实时 看 到 当 
前 下 载 的 进度 了 。 在 onsuccess() 方 法 中 ， 我 们 首先 是 将 正在 下 载 的 前 
台 通 知 关 闭 ， 然 后 了 创建 一 个 新 的 通知 用 于 告诉 用 户 下 载 成 功 了 。 1 
人 分 别 用 于 告诉 用 户 下 载 失 败 、 和 暂停 和 取消 这 

| 


接 下 来 为 了 要 让 DownloadService 可 以 和 活动 进行 通信 ， 我 们 又 创建 了 一 
个 DownloadBinder。DownloadBinder 中 提供 了 

startDownload()、 pauseDownload( ) 和 cancelDownload( ) 这 3 个 方法 ， 那 
么 顾名思义 ， 它 们 分 别 是 用 于 开始 下 载 、 暂 停 下 载 和 取消 下 载 的 。 

在 startDownload() 方 法 中 ， 我 们 创建 了 一 个 DownloadTask 的 实例 ， 把 











刚才 的 DownloadListener 作 为 参数 传 入 ， 然 后 调用 execute() 方 法 开启 下 
载 ， 并 将 下 载 文 件 的 URL 地 址 传 入 到 execute() 方 法 中 。 同 时 ， 为 了 让 
这 个 下 载 服务 成 为 一 个 前 台 服 务 ， 我 们 还 调用 了 startForeground() 方 
法 ， 这 样 就 会 在 系统 状态 栏 中 创建 一 个 持续 运行 的 通知 了 。 接 着 往 下 
看 ，pauseDownload() 方 法 中 的 代码 就 非常 简单 了 ， 就 是 简单 地 调用 了 一 
下 DownloadTask 中 的 pausepownload() 方 法 。cancelDownload() 方 法 中 的 
逻辑 也 基本 类 似 ， 但 是 要 注意 ， 取 消 下 载 的 时 候 我 们 需要 将 正在 下 载 的 
文件 删除 掉 ， 这 一 点 和 和 暂停 下 载 是 不 同 的 。 


另外 ，pownloadservice 类 中 所 有 使 用 到 的 通知 都 是 调 

用 getNotification() 方 法 进行 构建 的 ， 这 个 方法 中 的 代码 我 们 之 前 基本 
都 是 学 过 的 ， 只 有 一 个 setProgress() 方 法 没有 见 过 。 setProgress() 方 
法 接收 3 个 参数 ， 第 一 个 参数 传 入 通知 的 最 大 进度 ， 第 二 个 参数 传 入 通 
知 的 当前 进度 ， 第 三 个 参数 表示 是 否 使 用 模糊 进度 条 ， 这 里 传 

入 false。 设 置 完 setProgress() 方 法 ， 通 知 上 就 会 有 进度 条 显示 出 来 
J 


现在 下 载 的 服务 也 已 经 成 功 实现 ， 后 端的 工作 基本 都 完成 了 ， 那 么 接 下 
来 我 们 开 始 编 写 前 端的 部 分 。 修 改 activity_main.xml 中 的 代码 ， 如 下 所 
A]S* 




















<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<Button 
android:id="@+id/start_download" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Start Download" /> 


<Button 
android:id="@+id/pause_download" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Pause Download" /> 


<Button 
android:id="@+id/cancel_ download" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Cancel Download" /> 





</LinearLayout> 


布局 文件 还 是 非常 简单 的 ， 这 里 在 LinearLayout 中 放置 了 3 个 按钮 ， 分 别 
用 于 开始 下 载 、 暂 停 下 载 和 取消 下 载 。 


然后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


private DownloadService.DownloadBinder downloadBinder; 
private ServiceConnection connection = new ServiceConnection() { 


@Override 
public void onServiceDisconnected(ComponentName name) { 


} 


@Override 

public void onServiceConnected(ComponentName name, IBinder service) { 
downloadBinder = (DownloadService.DownloadBinder) service; 

} 


}; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity_main); 
Button startDownload = (Button) findvViewById(R.id.start_download); 
Button pauseDownload = (Button) findViewById(R.id.pause_download ) 
Button cancelDownload = (Button) findViewById(R.id.cancel download); 
startDown1load .setonCclickListener(this) 
pauseDownload.setOonClickListener(this); 
cancelDownload.setonClickListener(this); 
Intent intent = new Intent(this, DownloadService.class); 
startService(intent); // 启动 服务 
bindservice(intent，connection，BIND_AUTO_CREATE); // 绑 定 服务 
if (ContextCompat .checkSelfPermission(MainActivity.this，Manifest . 
permission.WRITE_EXTERNAL_STORAGE)1!= PackageManager .PERMISSION_GRANTED) { 
ActivityCompat.requestPermissions(MainActivity.this, new 
String[]{ Manifest.permission. WRITE_EXTERNAL_STORAGE }, 1); 


} 


@Override 
public void onClick(View v) { 
if (downloadBinder == null) { 
return; 
} 


Switch (v.getId()) { 

case R.id.start_download: 

String url = "https://raw.githubusercontent.com/guolindev/eclipse/ 
master/eclipse-inst-win64.exe"; 

downloadBinder.startDownload(url1); 
break; 

case R.id.pause_download: 
downloadBinder .pauseDownload( ); 
break; 

case R.id.cancel download: 
downloadBinder .cancelDownload( ); 


break; 
default: 
break; 
了 
} 
@override 


public void onRequestPermissionsResult(int requestCode, String[] permissions, 
int[] grantResults) { 
switch (requestCode) { 
CaSO 
if (grantResults.length > 0 && grantResults[0] != PackageManager. 
PERMISSION_GRANTED) { 
Toast .makeText(this, "拒绝 权限 将 无 法 使 用 程序 "，Toast .LENGTH_SHORT ) . 














show( ); 
finish(); 
break; 
default: 
} 
} 
@Override 


protected void onDestroy() { 
super .onDestroy(); 
unbindService(connection); 


可 以 看 到 ， 这 里 我 们 首先 创建 了 一 个 serviceconnection 的 匿名 类 ， 然 后 
在 onserviceconnected() 方 法 中 获取 到 DownloadBinder 的 实例 ， 有 了 这 
个 实例 ， 我 们 就 可 以 在 活动 中 调用 服务 提供 的 各 种 方法 了 。 


接 下 来 看 一 下 oncreate() 方 法 ， 在 这 里 我 们 对 各 个 按钮 都 进行 了 初始 化 
操作 并 设置 了 点 击 事件 ， 然 后 分 别 调用 了 startservice() 和 
bindSservice() 方 法 来 启动 和 绑 定 服务 。 这 一 点 至 关 重 要 ， 因 为 启动 服 
务 可 以 保证 DownloadService 一 直 在 后 台 运 行 ， 绑 定 服 务 则 可 以 让 
MainActivity 和 DownloadService 进 行 通 信 ， 因 此 两 个 方法 调用 都 必 不 可 
少 。 在 oncreate() 方 法 的 最 后 ， 我 们 还 进行 了 WRITE_EXTERNAL_STORAGE 
的 运行 时 权限 申请 ， 因 为 下 载 文 件 是 要 下 载 到 SD 卡 的 Download 目 录 下 
的 ， 如 果 没 有 这 个 权限 的 话 ， 我 们 整个 程序 都 无 法 正常 工作 。 


接 下 来 的 代码 就 非常 简单 了 ， 在 onclick() 方 法 中 我 们 对 点 击 事件 进行 
间断， 如果 点 击 了 开始 按钮 就 调用 DownloadBinder 的 startDown1load() 方 
法 ， 如 果 点 击 了 和 暂停 按钮 就 调用 pauseDpownload() 方 法 ， 如 果 点 击 了 取消 
按钮 就 调用 cancelDownload() 方 法 。startDownload() 方 法 中 你 可 以 传 入 
任意 的 下 载 地 址 ， 这 里 我 使 用 了 一 个 Eclipse 的 下 载 地 址 ， 以 此 辐 这 个 
Android 平 台 上 曾经 最 出 色 的 开发 工具 致敬 。 


另外 还 有 一 点 需要 注意 ， 如 果 活 动 被 销毁 了 ， 那 么 一 定 要 记得 对 服务 进 
行 解 绑 ， 不 然 就 有 可 能 会 造成 内 存 泄 漏 。 这 里 我 们 在 onpestroy() 方 法 
中 完成 了 解 绑 操 作 。 


现在 只 差 最 后 一 步 了 ， 我 们 还 需要 在 AndroidManifest,.xml 文 件 中 声明 使 
用 到 的 权限 。 当 然 除 了 权限 之 外 ，MainActivity 和 DownloadService 也 是 
需要 声明 的 ， 不 过 Android ， Studio 应 该 早 就 帮 有 我 们 将 这 两 个 组 件 声明 好 
了 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
example.servicebestpractice"> 





Sion.INTERNET" / 


ndroid:name="android.permis 
droid:name="android.permission.WRITE_ EXTERNAL_STORAGE" /> 


ation 

roid:allowBackup="true" 
icon="@mipm 

supportsRtl="true 

> heme="@style/AppTheme"> 

<activity android:name=" .MainActivity"> 

android:name="android.intent.action.MAIN" /> 


ory android:name="android.intent.category.LAUNCHER" /> 
ter> 


</manifest> 


其 中 ， 由 于 我 们 的 程序 使 用 到 了 网 络 和 访问 SD 卡 的 功能 ， 因 此 需要 声 


明 INTERNET 和 WwRITE_EXTERNAL_STORAGE 这 两 个 权限 。 


这 样 所 有 代码 就 都 编写 完了 ， 现 在 终于 可 以 运行 一 下 程序 了 ， 如 图 
10.16 所 示 。 
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图 10.16 申请 访问 SD 卡 权 限 


程序 一 启动 立刻 束 会 申请 访问 SD 卡 的 权限 ， 这 里 我 们 点 击 ALLOW， 然 
后 点 击 Start Download 按钮 就 可 以 开始 下 载 了 。 下 载 过 程 中 可 以 下 拉 系 
统 状态 栏 查 看 实时 的 下 载 进 度 ， 如 图 10.17 所 示 。 


二 ， Downloading... 
19% 





图 10.17 查看 实时 的 下 载 进 度 


同时 ， 我 们 还 可 以 点 击 Pause Download 或 Cancel Download， 甚 至 于 断 网 
操作 来 测试 这 个 下 载 程序 的 健壮 性 。 最 终 下 载 完成 后 会 弹出 一 个 
Download ”Success 的 通知 ， 然 后 我 们 可 以 通过 任意 一 个 文件 浏览 右 来 查 
看 一 下 SD 卡 的 Download 上 有 目录， 如 图 10.18 所 示 。 
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/storage/emulated/0/Download 


DOWNLOAD 
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eclipse-inst-win64.exe 
01 Jul 16 15:46:21 44.78MB rw-rw 








图 10.18 碍 看 SD 卡 的 Download 目录 
可 以 看 到 ， 文 件 已 经 成 功 下 载 下 来 了 。 


当然 ， 我 们 还 可 以 做 一 些 更 加 丰富 的 操作 ， 比 如 说 再 次 点 击 Start 
Download 按 钮 ， 你 会 发 现 程序 会 立刻 弹出 一 个 Download ”Success 的 提 
示 ， 因 为 它 检 测 到 文件 已 经 下 载 完成 了 ， 因 而 不 会 再 重新 去 下 载 一 遍 。 
如 果 我 们 点 击 Cancel ”Download 按钮 先 将 下 载 文件 删除 掉 ， 然 后 再 点 击 
Start Download 按 钮 ， 你 就 会 发 现 程 序 义 会 开始 重新 下 载 了 。 


总 体 来 说 ， 这 个 下 载 示例 的 稳定 性 还 是 挺 不 错 的 ， 而 且 综 合 性 很 强 ， 将 
这 个 示例 完全 掌握 了 之 后 ， 你 的 水 平 肯 定 又 更 进一步 了 。 


好 了 ， 最 佳 实践 部 分 到 此 结束 ， 下 面 我 们 就 来 回顾 一 下 本 章 所 学 的 内 容 








10.7 小 结 与 点 评 


在 本 章 中 ， 我 们 学 习 了 很 多 与 服务 相关 的 重要 知识 点 ， 包 括 Android 多 
线程 编程 、 服 务 的 基本 用 法 、 服 务 的 生命 周期 、 前 台 服 务 和 
IntentService 和 等。 这些 内 容 已 经 窗 六 了 大 部 分 你 在 日 党 开发 中 可 能 用 到 
的 服务 搁 术 ， 再 加 上 最 佳 实践 部 分 学 习 的 下 载 示 例 程 序 ， 相 信 以 后 不 管 
过 到 什么 样 的 服务 难题 ， 你 都 能 从 容 解 决 。 


另外 ， 本 章 同样 是 有 里 程 碑 式 的 纪念 意义 的 ， 因 为 我 们 已 经 将 Android 

中 的 四 大 组 件 全 部 学 完 ， 并 且 本 书 的 内 容 也 学 习 一 大 半 了 。 对 于 你 来 

说 ， 现 在 你 已 经 脱离 了 Android 初 级 开发 者 的 身份 ， 并 应 该 具备 了 独立 

完成 很 多 功能 的 能 力 。 

那么 后 面 我 们 应 该 再 接 再 厉 ， 争 取 进 一 步 提升 自身 的 能 力 ， 所 以 现在 还 

不 是 放松 的 时 候 ， 下 一 音 中 我 们 准备 去 学 习 一 RAndroid 特 色 开发 的 
容 。 























第 11 章 Android 特色 开发 一 基于 
位 置 的 服务 


现在 你 已 经 学 会 了 非常 多 的 Android 技 能 ， 并 且 通 过 这 些 技能 你 完全 可 
以 编写 出 相当 不 错 的 应 用 程序 了 。 不 过 本 章 中 ， 我 们 将 要 学 习 一 些 全 新 
的 Android 撤 术 ， 这 些 技术 有 别 于 传统 的 PC 或 Web 领 域 的 应 用 技术 ， 是 
只 有 在 移动 设备 上 才能 实现 的 。 


说 到 只 有 在 移动 设备 上 才能 实现 的 技术 ， 很 容易 就 让 人 联想 到 基于 位 置 
的 服务 (Location Based Service) 。 由 于 移动 设备 相 比 于 电脑 可 以 随身 
携带 ， 我 们 通过 地 理 定位 的 技术 就 可 以 随时 得 知 上 自己 所 在 的 位 置 ， 从 而 
围绕 这 一 点 开发 出 很 多 有 意思 的 应 用 。 本 间 中 我 们 就 将 针对 这 一 点 进行 
讨论 ， 学 习 一 下 基于 位 置 的 服务 究竟 是 如 何 实现 的 。 














11.1 基于 位 置 的 服务 简介 


基于 位 置 的 服务 简称 LBS， 随 着 移动 互联 网 的 兴起 ， 这 个 技术 在 最 近 的 
几 年 里 十 分 火爆 。 其 实 它 本 身 并 不 是 什么 时 菜 的 技术 ， 主 要 的 工作 原理 
就 是 利用 无 线 电 通讯 网 络 或 GPS 等 定位 方式 来 确定 出 移动 设备 所 在 的 位 
置 ， 而 这 种 定位 技术 早 在 很 多 年 前 就 已 经 出 现 了 。 


那 为 什么 LBS 扩 术 直 到 最 近 几 年 才 开 始 流行 呢 ? 这 主要 是 因为 ， 在 过 去 
移动 设备 的 功能 极其 有 限 ， 即 使 定位 到 了 设备 所 在 的 位 置 ， 也 就 仅仅 只 
是 定位 到 了 而 已 ， 我 们 并 不 能 在 位 置 的 基础 上 进行 一 些 其 他 的 操作 。 而 
现在 就 大 大 不 同 了 ， 有 了 Android 系 统 作为 载体 ， 我 们 可 以 利用 定位 出 
的 位 置 进行 许多 丰富 多 彩 的 操作 。 比 如 说 天 气 预报 程序 可 以 根据 用 户 所 
在 的 位 置 目 动 选择 城市 ， 发 微 博 的 时 候 我 们 可 以 同 朋 友 们 晒 一 下 目 己 在 
哪里 ， 不 认识 路 的 时 候 随 时 打开 地 图 就 可 以 查询 路 线 ， 等 等 。 


介绍 了 这 么 多 ， 相 信 你 已 经 按 探 不 住 了 吧 ? 我 们 马上 就 要 开始 本 章 的 学 
习 之 旅 ， 但 在 开始 之 前 ， 还 有 一 些 事情 是 你 必须 要 知道 的 。 


首先 你 要 清楚 ， 基 于 位 置 的 服务 所 围绕 的 核心 就 是 要 先 确定 出 用 户 所 在 
的 位 置 。 通 第 有 两 种 技术 方式 可 以 实现 :一 种 是 通过 GPS 定 位 ， 一 种 是 
通过 网 络 定位 。GPS 定 位 的 工作 原理 是 基于 手机 内 置 的 GPS 硬件 直接 和 
卫星 交互 来 获取 当前 的 经 纬度 信息 ， 这 种 定位 方式 精确 度 非 常 高 ， 但 缺 
点 是 只 能 在 室外 使 用 ， 室 内 基本 无 法 接收 到 卫星 的 信号 。 网 络 定位 的 工 
作 原 理 是 根据 手机 当前 网 络 附近 的 三 个 基站 进行 测速 ， 以 此 计算 出 手机 
和 每 个 基站 之 间 的 距离 ， 再 通过 三 角 定 位 确定 出 一 个 大 概 的 位 置 ， 这 种 
定位 方式 精确 度 一 般 ， 但 优点 是 在 室内 室外 都 可 以 使 用 。 


Android 对 这 两 种 定位 方式 都 提供 了 相应 的 API 文 持 ， 但 是 由 于 一 些 特殊 
原因 ，Google 的 网 络 服务 在 中 国 不 可 访问 ， 从 而 导致 网 络 定 位 方式 的 
API 失 效 。 而 GPS 定位 虽然 不 需要 网 络 ， 但 是 必须 要 在 室外 才 可 以 使 
用 ， 因 此 你 在 室内 开发 的 时 候 很 有 可 能 会 遇 到 不 管 使 用 哪 种 定位 方式 都 
无 法 成 功 定位 的 情况 。 


基于 以 上 原因 ， 我 决定 就 不 在 本 书 中 讲解 Android 原 生 定 位 API 的 用 法 
了 ， 而 是 使 用 一 些 国内 第 三 方 公司 的 SDK。 目 前 国内 在 这 一 领域 做 得 比 






























































较 好 的 一 个 是 百度 ， 一 个 是 高 德 ， 本 章 我 们 就 来 学 习 一 下 百度 在 LBS 方 
面 提 供 的 丰富 多 彩 的 功能 。 


11.2 ”申请 API Key 


要 想 在 上 自己 的 应 用 程序 里 使 用 百度 的 LBS 功 能 ， 首 先 必 须 申请 一 个 API 
Key。 你 得 拥有 一 个 百度 账号 才能 进行 申请 ， 我 相信 大 多 数 人 早 束 已 经 
拥有 了 吧 ? 如 果 你 还 没有 的 话 ， 赶 快 去 注册 一 个 吧 。 


有 了 百度 账号 之 后 ， 我 们 就 可 以 申请 成 为 一 名 百度 开发 者 了 了， 登录 你 的 
百度 账号 ， 并 打开 http://developer.baidu.com/user/reg 这 个 网 址 ， 在 这 里 
填写 一 些 注册 信息 即 可 ， 如 图 11.1 所 示 。 








“类 型 : 国人 OO 〇 各 








* 开发 者 来 源 : 开 & 者 -|@ 
* 开发 者 姓名 : 郭 索 © 
* 开发 者 简介 : [Android 开 发 人 员 . 2 








* Emailitt 址 : 5ixzxxxxxx7Osina.Ccom ”修改 
* 手机 号 : 159**###036 ee 
* 验证 码 : 114039 bd 

















开发 者 官方 网 站 : | 
品牌 L0GO : 112px*54px， 支 持 PNG/JPG/GIF 格 式 ， 应 用 提交 至 PC 
Web 汇 道 时 进行 展示 


和 一 一 一 一 一 一 一 一 一 上 


我 已 阅读 并 同意 百度 开放 云 平台 注册 协议 


提交 





图 11.1 填写 开发 者 信息 


只 需 填 写 带 有 “*” 写 的 那 部 分 内 容 就 足够 了 ， 接 下 来 点 击 提交 
如 图 11.3 所 示 的 界面. 











填写 开发 者 信息 验证 邮箱 提交 应 用 / 使 用 开放 云 服务 


一 人 一 一 全- 一 


验证 邮件 已 经 发 送 至 您 的 邮箱 si******** 7@sina.com 
请 点 击 邮件 中 的 激活 链接 完成 验证 ， 即 可 使 用 百度 强大 的 应 用 分 发 渠道 和 丰富 的 开放 云 服务 。 


去 我 的 邮箱 > > 


图 11.2 ”验证 邮箱 
接着 点 击 “ 去 我 的 邮箱 ”， 将 会 进入 到 我 们 刚才 填写 的 邮箱 当中 ， 这 时 收 


件 箱 中 应 该 会 有 一 封 刚 刚 收 到 的 邮件 ， 这 残 是 百度 发 送 给 我 们 的 验证 邮 
件 ， 点 击 邮 件 当中 的 链接 就 可 以 完成 注册 了 ， 如 图 11.3 所 示 。 


填写 开发 者 信息 验证 邮箱 提交 应 用 / 使 用 开放 云 服务 


@ 日 © 


邮箱 验证 成 功 ， 蒜 喜 您 成 为 百度 开发 者 ! 
百度 开放 云 平台 不 仅 将 百度 的 技术 和 大 数据 能 力 开放 给 广大 开发 者 ， 更 有 强力 的 应 用 推广 渠道 ， 
双全 合璧 为 您 的 成 功 加 速 ! 


图 11.3 成 为 百度 开发 者 


到 此 一 切 顺 利 ! 这 样 你 就 已 经 成 为 一 名 百度 开发 者 了。 接着 访问 
http://lbsyun.baidu.com/apiconsole/key 这 个 地 址 ， 然 后 同意 百度 开发 者 协 
议 ， 会 看 到 如 图 11.4 所 示 的 界面 。 


应 用 编号 ”应 用 名 称 访问 应 用 ( AK ) 应 用 类 别 备注 信息 ( 双击 更 改 ) 应 用 配置 


您 当前 创建 了 0 个 应 用 


图 11.4 ”百度 LBS 开 放 平 台 主 界面 
由 于 这 是 一 个 刚刚 注册 的 账号 ， 所 以 目前 的 应 用 列表 是 空 的 。 接 下 来 点 


击 创建 应 用 就 可 以 去 申请 API Key 了 ， 应 用 名 称 可 以 随便 填 ， 应 用 类 型 
选择 Android SDK， 启 用 服务 保持 默认 即 可 ， 如 图 11.5 所 示 。 


应 用 名 称 : LBSTest 


应 用 类 型 : ” Android SDK " 


网 云 检索 ApPl 加 javascript API 回 Place API v2 
加 Geocoding API v2 四 ip 定位 Api 园 路线 交通 API 
网 Android 地 图 SDK 畴 Android 导 航 高 线 SDK 因 Android 导 航 SDK 
启用 服务 : ke 
四 静态 图 API 四 全 景 静 去 图 API 网 坐标 转换 APl 
JW 认 限 API 网 全 最 URL API 加 Android 导 航 HUD SDK 
网 云 送 地 理 编码 API 加 Routematrix API 


+ 发 布 版 SHA1 : 。 请 给 入 发 布 版 SHA] 
开发 版 SHA1 ;请 输 入 开发 版 SHA1 
* 包 各 ; 。 请 输入 包 名 
安全 码 : ”输入 shal 和 包 名 后 自动 生成 


Android SDK 安 全 码 组 成 : SHA1+ 包 名 。{ 查 看 详细 配置 方法 ) 
新 申请 的 Mobile 与 Browser 类 型 的 ak 不 再 支持 云 存 储 接 口 的 访问 ， 如 要 使 用 云 存 储 ， 请 申请 Server 类 型 ak。 


图 11.5 创建 应 用 界面 


那么 ， 这 个 发 布 版 SHA1 和 开发 版 SHA1 又 是 个 什么 东西 呢 ? 这 是 我 们 申 
请 API Key 所 必须 填写 的 一 个 字段 ， 它 指 的 是 打包 程序 时 所 用 签名 文件 
的 SHA1 指 纹 ， 可 以 通过 Android Studio 查 看 到 。 打 开 Android Studio 中 的 
任意 一 个 项 目 ， 点 击 右 侧 工 具 栏 的 Gradle -项目 名 :app Tasks 一 
android， 如 图 11.6 所 示 。 





| Gradle projects 浴 ， 下 
和 仿 十 一 | 亿 三 三 虹 咏 | 营 
(© ServiceBestpractice 
人 ServiceBestpractice (rooi 
© :app 
Es Tasks 
[8 android 
RandroidDependencies 





alpel9 2 


signingReport 
过 sourceSets 
Ca build 
[3 help 
Ca install 
[3 other 
[a verification 





图 11.6 查看 内 置 Gradle Tasks 





这 里 展示 了 一 个 Android ”Studio 项 目 中 所 有 内 置 的 Gradle Tasks， 其 中 
signingReport 这 个 Task 就 可 以 用 来 查看 签名 文件 信息 。 双 击 
signingReport， 结 果 如 图 11.7 所 示 。 











| Run ‘® ServiceBestPractice:app [signingReport] 





PP 个 22:50:17: Executing external task ' signingReport ... 
加 | 二 Configuration on demand is an incubating feature. 
3 Incremental java compilation is an incubating feature. 
i 加 :app: signingReport 
x Variant: debug 
? Config: debug 
Store: C:\Users\Administrator\. android\debug. keystore 
Alias: AndroidDebugKey 
MD5: 45:62:8A:DE:20:85:67:24:FE:8E:23:81:03:16:81:6A 
SHAl1: 91:16:04:30:C0:8B:6E:53:92:47:57:E6:FB:10:EF:08:1B:73:E6:3E 
Valid until: 2044 年 12 月 5 日 星期 一 


Pp 4 | i TODO EF €: Android Monitor 回 Terminal 国 @: Messages 
图 11.7 signingReport Task 的 执行 结 


其 中 ，91:16:04:30:C0:8B:6E:53:92:47:57:E6:FB:10:EF:08:1B:73:E6:3E 整 
是 我 们 所 需 的 SHA1 指 纹 了 ， 当 然 你 的 Android Studio 中 显示 的 指纹 和 我 
的 肯定 是 不 一 样 的 。 另 外 需要 注意 ， 目 前 我 们 使 用 的 是 debug.keystore 文 
件 所 生成 的 指纹 ， 这 是 Android 自 动 生成 的 一 个 用 于 测试 的 签名 文件 。 
而 当 你 的 应 用 程序 发 布 时 还 需要 创建 一 个 正式 的 签名 文件 ， 如 果 要 得 到 
它 的 指纹 ， 可 以 在 cemd 中 输入 如 下 命令 : 


keytool -list -v -keystore < 签名 文件 路 径 > 


然后 输入 正确 的 密码 就 可 以 了 。 创 建 签名 文件 的 方法 我 们 将 在 第 15 章 中 


学 习 。 


那么 也 就 是 说 ， 现 在 得 到 的 这 个 SHA1 指 纹 实 际 上 是 一 个 开发 版 的 SHA1 
指纹 ， 不 过 因为 暂时 我 们 还 没有 一 个 发 布 版 的 SHA1 指 纹 ， 因 此 这 两 个 
值 都 填 成 一 样 的 束 可 以 了 。 最 后 还 剩 下 一 个 包 名 选项 ， 虽 然 目 前 我 们 的 
应 用 程序 还 不 存在 ， 但 可 以 先 将 包 名 预定 下 来 ， 比 如 就 叫 

com.example.lbstest， 这 样 所 有 的 内 容 束 都 填写 完整 了 ， 如 图 11.8 所 示 。 





应 用 名 称 : 


启用 服务 : 


* 发 布 版 SHA1 : 


开发 版 SHA1 : 


# 名 名 : 


安全 码 : 


图 11.8 


LBSTest 


Android SDK Y 


回 云 检索 API 图 Javascript API 加 place API v2 

团 Geocoding APIv2 问 jp 定位 API 加 路 线 交 通 API 

加 Android 地 图 SDK 国 Android 导 航 高 线 SDK 加 Android 导 航 SDK 

加 静态 图 API 网 全 最 静态 图 API 坐标 转 搁 API 

因 磨 眼 API 圈 全 景 URL API 圈 Android 导 航 HUD SDK 
加 云 送 地 理 编 码 API 加 Routematrix API 


91:16:04:30:C0:8B:6E:53:92:47:57:E6:FB:10:EF:08:1B:73:E6:3E 
91:16:04:30:C0:8B:6E:53:92:47:57:;E6:FB:10:EF:08:1B:73:E6:3E 。。”@ 答 入 正确 


com.example.lbstest 


91:16:04:30:C0:8B:6E:53:92:47:57:E6:FB:10:EF:08:1B:73:E6:3E:com.example.lbstest 
91:16:04:30:CO:8B:6E:53:92:47:57:E6:FB:10:EF:08:1B:73:E6:3E:com.example.lbstest 


Android SDK 安 全 码 组 成 ; SHA1+ 包 各 ，( 查 看 详细 配置 方法 ) 
新 申请 的 Mobile 与 Browser 类 型 的 ak 不 再 支持 云 存 信 接 口 的 访问 ， 如 要 使 用 云 存 储 ， 请 申请 Server 类 型 ak， 


写 完 整 所 有 创建 应 用 的 信息 





接 下 来 点 击 提交 ， 应 用 就 应 该 创建 成 功 了 ， 如 图 11.9 所 示 。 


应 用 编号 。 应 用 名 称 访问 应 用 ( AK ) 应 用 类 别 


8351285 


您 当前 创建 了 1 个 应 用 


LBSTest i6VD2fHKM3msMfZtHOXAhFSzDiYGFiwL Android 请 设置 删除 


图 11.9 ”查看 已 创建 的 应 用 


其 中 ，i6VD2fHKM3msMfZtIOXAhFSzDiYGFIwL 就 是 申请 到 的 API 
Key， 有 了 它 就 可 以 进行 后 续 的 LBS 开 发 工作 了 ， 那 么 我 们 马上 开始 
吧 。 


11.3 ”使 用 百度 定位 


现在 正 是 趁 热 打铁 的 好 时 机 ， 新 建 一 个 LBSTest 项 目 ， 包 名 应 该 就 会 自 
动 被 命名 为 com.example.lbstest。 男 外 需要 注意 ， 本 章 中 所 写 的 代码 建议 
你 都 在 手机 上 运行 ， 虽 然 模拟 器 中 也 提供 了 模拟 地 理 位 置 的 功能 ， 但 在 
手机 上 可 以 得 到 真实 的 位 置 数据 ， 你 的 感受 会 更 加 深刻 。 


11.3.1 准备 LBS SDK 


在 开始 编码 之 前 ， 我 们 还 需要 先 将 百度 LBS 开 放 平 台 的 SDK 准 备 好 ， 下 
载 地 址 是 : http:/lbsyun.baidu.com/sdk/download。 本 章 中 我 们 会 用 到 基 
础 地 图 和 定位 功能 这 两 个 SDK， 将 它们 义 选 上 ， 然 后 点 击 “ 开 发 包 ” 下 载 


按钮 即 可 ， 如 图 11.10 所 示 。 











选择 并 下 载 相 应 功能 的 开发 资源 
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图 11.10 下载 SDK 界 面 





下 载 完成 后 对 该 压缩 包 解压 ， 其 中 会 有 一 个 libs 目 录 ， 这 里 面 的 内 容 如 
是 我 们 所 需要 的 一 切 了 ， 如 图 11.11 所 示 。 

名 称 t 类 型 大 小 

Dh arm64-v8a 文件 去 

Dh armeabi 文 

DD armeabi-v7a 文件 去 

是 x86 文件 去 

国 x86 64 文件 去 

车 | BalduLBS_AndroldJar Executable Jar File 1,232 KB 


图 11.11 压缩 包 libs 目 录 下 的 内 容 


libs 目 录 下 的 内 容 又 分 为 两 部 分 ，BaiduLBS_Android.jar 这 个 文件 是 Java 
层 要 使 用 到 的 ， 其 他 子 目录 下 的 so 文件 是 Native 层 要 用 到 的 。so 文 件 是 
用 C/C++ 语 言 进 行 编写 ， 然 后 再 用 NDK 编 译 出 来 的 。 当 然 这 里 我 们 并 不 
需要 去 编写 C/C++ 的 代码 ， 因 为 百度 都 已 经 做 好 了 封装 ， 但 是 我 们 需要 
将 libs 目 录 下 的 每 一 个 文件 都 放置 到 正确 的 位 置 。 


首先 观察 一 下 当前 的 项 目 结构 ， 你 会 发 现 app 模 块 下 面 有 一 个 libs 目 录 ， 
这 里 就 是 用 来 存放 所 有 的 Jar 包 的 ， 我 们 将 BaiduLBS_Android.jar 复 制 到 
这 里 ， 如 图 11.12 所 示 。 








C3 LBSTest 

户 .gradle 

DD .idea 

[3 app 
DD build 
口 libs 

日 | BaiduLBS_Android,ar 

站 src 
目 .gitignore 
[3 app.iml 
(© build.gradle 


目 proguard-rules.pro 
图 11.12 将 Jar 包 放置 到 libs 目 录 中 
接 下 来 展开 srcmain 目 录 ， 碳 击 该 目录 -New”Directory， 再 创建 一 个 名 





为 jniLibs 的 目录 ， 这 里 就 是 专门 用 来 存放 so 文件 的 ， 然 后 把 压缩 包 里 的 
其 他 所 有 目录 直接 复制 到 这 里 ， 如 图 11.13 所 示 。 


疡 src 
四 androidTest 
四 main 
四 java 
户 jniLibs 
四 arm64-v8a 
DD armeabi 
四 armeabi-v7a 
四 x86 
四 x86_ 64 
[3 res 
Bl AndroidManifest.xml 











图 11.13 将 so 文件 放置 到 jniLibs 目 录 中 


另外 ， 虽 然 所 有 新 创建 的 项 目 中 ，app/build.gradle 文 件 都 会 默认 配置 以 
下 这 段 声明 : 


这 表示 会 将 libs 目 录 下 所 有 以 jar 结尾 的 文件 添加 到 当前 项 目的 引用 中 。 
但 是 由 于 我 们 是 直接 将 Jar 包 复制 到 libs 目 录 下 的 ， 并 没有 修改 gradle 文 
件 ， 因 此 不 会 弹出 我 们 平时 熟悉 的 Sync Now 提 示 。 这 个 时 候 必须 手动 点 
击 一 下 Android Studio 顶部 工具 栏 中 的 Sync 按钮 〈 图 11.14 中 最 左边 的 按 
钮 ) ， 不 然 项 目 将 无 法 引用 到 Jar 包 中 提供 的 任何 接口 。 





G J Hy 
图 11.14 Android Studio 顶 部 工具 栏 


点 击 Sync 按 钮 之 后 ，libs 目 录 下 的 jar 文 件 就 会 多 出 一 个 向 右 的 箭头 ， 这 
就 表示 项 目 己 经 能 引用 到 这 些 Jar 包 了 ， 如 图 11.15 所 示 。 





思 libs 
目 BaiduLBS_AndroldJjar 


图 11.15 Jar 包 引用 成 功 

好 了 ， 这 样 我 们 就 把 LBS 的 SDK 都 准备 好 了 ， 接 下 来 开始 编码 吧 。 
11.3.2 ”确定 自己 位 置 的 经 纬度 

首先 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<TextView 
android:id="@+id/position_text_view" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" /> 


</LinearLayout> 


布局 文件 中 的 内 容 非 营 简 单 ， 只 有 一 个 TextView 控 件 ， 用 于 稍 后 显示 当 
前 位 置 的 经 纬度 信息 。 


然后 修改 AndroidManifest.xml 文 件 中 的 代码 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.lbstest"> 





<uses-permission android:name="android.permission.ACCESS COARSE_LOCATION"/> 
<uses-permission android:name="android.permission.ACCESS FINE_ LOCATION"/> 
<uses-permission android:name="android.permission.ACCESS_ WIFI_STATE"/> 
<uses-permission android:name="android.permission.ACCESS NETWORK_STATE"/> 
<uses-permission android:name="android.permission.CHANGE_ WIFI_STATE"/> 
<uses-permission android:name="android.permission.READ_PHONE_STATE"/> 
<uses-permission android:name="android.permission.WRITE_ EXTERNAL_STORAGE"/> 
<uses-permission android:name="android.permission.INTERNET"/> 

<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/> 
<uses-permission android:name="android.permission.WAKE_LOCK"/> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<meta-data 
android:name="com.baidu.lbsapi.API_KEY" 
android:value="i6VD2fHKM3msMfZtIOXAhFSzDiYGFIwL" /> 


<activity android:name=" .MainActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 


<service android:name="com.baidu.location.f" android:enabled="true" android:process=":remote"> 
</service> 
</application> 


</manifest> 


AndroidManifest.xml 文 件 改动 比较 多 ， 我 们 来 仔细 阅读 一 下 。 可 以 看 
到 ， 这 里 首先 添加 了 很 多 行 权 限 声明 ， 每 一 个 权限 都 是 百度 LBS SDK 内 
部 要 用 到 的 。 然 后 在 <application> 标 签 的 内 部 添加 了 一 个 <meta-data> 
标签 ， 这 个 标签 的 android:name 部 分 是 固定 的 ， 必 须 

填 com.,baidu.lbsapi.API_KEY，android:value 部 分 则 应 该 填 入 我 们 在 
11.2 节 申请 到 的 API Key。 最后， 还 需要 再 注册 一 个 LBS SDK 中 的 服 
务 ， 不 用 对 这 个 服务 的 名 字 感 到 疑惑 ， 因 为 百度 LBS SDK 中 的 代码 都 是 
混 请 过 的 。 


接 下 来 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
public LocationClient mLocationClient; 
private TextView positionText; 


@override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
mLocationClient = new LocationClient(getApplicationContext()); 
mLocationClient.registerLocationListener(new MyLocationListener()); 
setContentView(R.1layout.activity main); 
positionText = (TextView) findViewById(R.id.position_ text_view); 
List<String> permissionList = new ArrayList<>(); 
if (ContextCompat .checkSelfPermission(MainActivity.this，Manifest . 
permission.ACCESS_FINE_ LOCATION)!= PackageManager .PERMISSION_GRANTED) { 
permissionList.add(Manifest.permission.ACCESS_FINE_ LOCATION); 


if (ContextCompat.checkSelfPpermission(MainActivity.this, Manifest. 
permission.READ_PHONE_STATE) != PackageManager .PERMISSION_ GRANTED) { 
permissionList.add(Manifest.permission.READ_ PHONE_STATE) 





if (ContextCompat.checkSelfPpermission(MainActivity.this, Manifest. 
permission.WRITE_EXTERNAL_STORAGE)!= PackageManager .PERMISSION_ GRANTED) { 
permissionList.add(Manifest.permission.WRITE_ EXTERNAL_STORAGE); 





} 
if (!permissionList.isEmpty()) { 
String [] permissions = permissionList.toArray(new String[permissionList. 
size()]); 
ActivityCompat.requestPermissions(MainActivity.this, permissions, 1); 
} else { 
requestLocation(); 
} 


} 


private void requestLocation() { 
mLocationClient. start(); 
} 


@override 
public void onRequestPermissionsResult(int requestCode, String[] permissions, 
int[] grantResults) { 
switch (requestCode) { 
Case +: 
if (grantResults.length > 0) { 
for (int result : grantResults) { 
if (result != PackageManager .PERMISSION_ GRANTED) { 
Toast .makeText(this, "必须 同意 所 有 权限 才能 使 用 本 程序 "， 
Toast .LENGTH_SHORT) .show( ); 
finish(); 
return; 














} 
J 
requestLocation(); 
} else { 
Toast .makeText(this，" 发 生 未 知 错误 "， Toast .LENGTH_SHORT).show(); 
Tintshtys 





} 
break; 
default: 


} 
public class MyLocationListener implements BDLocationListener { 
@Override 


public void onReceiveLocation(BDLocation location) { 
runonUiThread(new Runnable() { 


@override 
public void run() { 
StringBuilder currentPosition = new StringBuilder(); 
currentPosition.append(" 纬 度 : ") .append(location.getLatitude() ) . 
append("\n"); 
Ca Pon oS on append(' "经 线 : ") .append(location.getLongitude()). 
append( "AN 
PSSYEiDH append(" 定位 方式 : ") ; 
if (location.getLocType() == BDLocation.TypeGpsLocation) { 
currentPosition.append("GPS"); 
} else if (location.getLocType() = 
BDLocation. TypeNetworkL Ocation) 人 
currentPosition.append(" 网 络 ") ; 
} 
positionText.setText(currentPosition); 
} 
}); 
} 


Q@override 
public void onConnectHotSpotMessage(String s, int i) { 


} 


可 以 看 到 ， 在 oncreate() 方 法 中 ， 我 们 首先 创建 了 一 广 LocationC1lLient 
的 实例 ，Locationclient 的 构建 函数 接收 一 个 context 参 数 ， 这 里 调 
人 

入 。 然 后 调用 Locationclient 的 registerLocationListener() 方 法 来 注册 
一 个 定位 监听 器 ， 当 获取 到 位 置信 息 的 时 候 ， 束 会 回调 这 个 定位 监听 
区。 


接 下 来 看 一 下 这 里 运行 时 权限 的 用 法 ， 由 于 我 们 在 AndroidManifest.xml 
参考 一 下 7.2.1 小 节 中 的 危险 权限 表格 可 以 发 现 ， 其 
ACCESS_COARSE_LOCATION、 ACCESS_FINE_LOCATION、 READ PHONE STATE、 
这 4 个 权限 是 需要 进行 运行 时 权限 处 理 的 ， 不 过 由 于 
ACCESS_COARSE_LOCATION 和 ACCESS_FINE_ LocATION 必 属于 同一 个 权限 组 ， 
因此 两 者 只 要 申请 其 一 就 可 以 了 。 那 么 怎样 才能 在 运行 时 一 次 性 申请 3 
J 这 里 我 们 使 用 了 一 种 新 的 用 法 ， 首先 创建 一 个 空 的 List 集 
合 ， 然 后 依次 判断 这 3 个 权限 有 没有 被 授权 ， 如 果 没 被 授权 就 添加 到 List 
集合 中 ， 最 后 将 List 转 换 成 数组 ， 再 调 


用 ActivityCcompat .requestPermissions( ) 方 法 一 次 性 申请 。 














除 此 之 外 ，onRequestPermissionsResult() 方 法 中 对 权限 申请 结果 的 逻 
辑 处 理 也 和 之 前 有 所 不 同 ， 这 次 我 们 通过 一 个 循环 将 申请 的 每 个 权限 都 
进行 了 判断 ， 如 果 有 任何 一 个 权限 被 拒绝 ， 那 么 就 直接 调用 finish() 方 
法 关闭 当前 程序 ， 只 有 当 所 有 权限 都 被 用 户 同 意 了 ， 才 会 调 

用 requestLocation() 方 法 开始 地 理 位 置 定位 。 





requestLocation() 方 法 中 的 代码 比较 简单 ， 只 是 调用 了 一 

下 Locationclient 的 start() 方 法 束 能 开始 定位 了 。 定 位 的 结果 会 回调 到 
我 们 前 面 注册 的 监听 器 当中 ， 也 就 是 MyLocationListener。 观 察 一 下 
MYyLocationListener 的 onReceiveLocation( ) 方 法 中 ， 在 这 里 我 们 通过 
BDLocation 的 getLatitude() 方 法 获取 当前 位 置 的 纬度 ， 通 过 
getLongitudel( ) 方 法 获取 当前 位 置 的 经 度 ， 通过 get LocType( ) 方 法 获取 
当前 的 定位 方式 ， 最 终 将 结果 组 装 成 一 个 字符 串 ， 显 示 到 TextView 上 
面 。 

















现在 我 们 可 以 来 运行 一 下 程序 了 ， 如 图 11.16 所 示 。 至 无 疑问 ， 打 开 程 
序 首先 就 会 弹出 运行 时 权限 的 申请 对 话 框 ,注意 看 对 话 框 的 底部 ， 提 示 
我 们 一 共有 3 项 权限 申请 ， 当 前 是 第 1 项 ， 授 权 了 第 1 项 后 就 会 显示 第 2 
项 ， J 然后 就 会 立刻 开始 定位 了 ， 结 果 如 图 
11.17 所 未 。 
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图 11.16 运行 时 权限 申请 对 话 框 
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图 11.17 地 理 位 置 定位 的 结果 
可 以 看 到 ， 设 备 当前 的 经 纬度 信息 已 经 成 功 定 位 出 来 了 。 


不 过 ， 在 默认 情况 下 ， 调 用 LocationClient 的 start() 方 法 只 会 定位 一 
次 ， 如 果 我 们 正在 快速 移动 中 ， 怎 样 才能 实时 更 新 当前 的 位 置 呢 ? 为 
此 ， 百 度 LBS SDK 提 供 了 一 系列 的 设置 方法 ， 来 允许 我 们 更 改 默认 的 行 
为 ， 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 








private void requestLocation() { 
initLocation(); 
mLocationClient.start(); 


private void initLocation(){ 
LocationClientOption option = new LocationClientOption(); 


etSca 2 n(5000) 
mLo aa 人 onclie etLocOption(option); 


et Ete 6 odie ns stroy() { 
super .onD oy(); 


} 
@ov 
pro 

mLoc onenis rteotoptys 
} 


这 里 增加 了 一 个 initLocation() 方 法 ， 在 initLocation() 方 法 中 我 们 创 
建 了 一 个 Locationclientoption 对 象 ， 然 后 调用 它 的 setscanspan() 方 法 
来 设置 更 新 的 间隔 。 这 里 传 入 了 5000， 表 示 每 5 秒 钟 会 更 新 一 下 当前 的 
位 置 。 


最 后 要 记得 ， 在 活动 被 销毁 的 时 候 一 定 要 调用 Locationclient 的 stop() 
方法 来 停止 定位 ， 不 然 程 序 会 持续 在 后 台 不 停 地 进行 定位 ， 从 而 严重 消 
耗 手机 的 电量 。 


现在 重新 运行 一 下 程序 ， 然 后 拿 着 手机 随处 移动 ， 你 会 发 现 界 面 上 的 经 
纬度 信息 也 会 跟着 一 起 变化 的 。 


11.3.3 ”选择 定位 模式 


还 记得 在 本 章 刚 开始 的 时 候 说 过 ，Android 中 主要 有 两 种 定位 方式 吗 ? 
一 种 是 通过 GPS 定位 ， 一 种 是 通过 网 络 定位 。 而 从 上 一 小 节 中 的 例子 中 
应 该 可 以 看 出 ， 我 们 一 直 是 使 用 的 网 络 定位 。 那 么 如 何 才 能 切换 到 精确 
度 更 高 的 GPS 定位 呢 ? 本 小 节 我 们 就 来 学 习 一 下 。 


首先 ，GPS 定 位 功能 必须 要 ee 不 然 任何 应 用 程序 
都 无 法 使 用 GPS 获取 到 手机 当前 的 位 置信 息 。 进 入 手机 的 设置 ~ 位 置信 
息 ， 如 图 11.18 所 示 。 
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图 11.18 位 置信 息 设 置 界面 


我 们 可 以 通过 顶部 的 开关 来 控制 定位 功能 是 开局 还 是 关闭 ， 男 外 ， 扣 
击 “ 模 式 ” 可 以 选择 上 其 体 的 定位 模式 ， 如 图 11.19 所 示 。 


《 ”位 置信 息 模式 





仅 限 设备 O 





图 11.19 选择 具体 的 定位 模式 


其 中 ， 高 精确 度 模式 表示 人 允许 使 用 GPS、 无 线 网 络 、 监 牙 或 移动 网 络 来 
进行 定位 ， 市 电 模 式 表 示 仅 允许 使 用 无 线 网 络 、 蓝 牙 或 移动 网 络 来 进行 
定位 ， 而 仪 限 设备 模式 表示 仪 允 许 使 用 GPS 来 进行 定位 。 也 就 是 广 ， 如 
末 我 们 想 要 使 用 GPS 定位 功能 ， 这 里 必须 要 选择 高 精确 度 模 式 ， 或 者 仅 
限 设 备 模 式 。 


当然 ， 你 并 不 需要 担心 一 旦 启用 GPS 定位 功能 后 ， 手 机 的 电量 就 会 直线 
下 滑 ， 这 只 是 表明 你 已 经 同意 让 应 用 程序 来 对 你 的 手机 进行 GPS 定位 
了 ， 但 只 有 当 定 位 操作 真正 开始 的 时 候 ， 才 会 影响 到 手机 的 电量 。 














开局 了 GPS 定位 功能 之 后 ， 再 回来 看 一 下 人 代码。 我们 可 以 

在 initLocation() 方 法 中 对 百度 LBS SDK 的 定位 模式 进行 指定 ， 一 共有 
3 种 模式 可 选 : Hight_Accuracy、Battery_Saving 和 Device_Sensors。 
Hight_Accuracy 表 未 噩 精确 度 模 式 ， 会 在 GPS 信和 号 正常 的 情况 下 优先 使 
用 GPS 定位 ， 在 无 法 接收 GPS 信号 的 时 候 使 用 网 络 定位 。Battery_Saving 
表示 节 电 模式 ， 只 会 使 用 网 络 进行 定位 。Device_Sensors 表 示 传 感 堪 模 
式 ， 只 会 使 用 GPS 进行 定位 。 其 中 ，Hight_Accuracy 是 默认 的 模式 ， 也 
就 是 说 ， 我 们 即使 不 修改 任何 代码 ， 只 要 拿 着 手机 走 到 室外 去 ， 让 手机 
可 以 接收 到 GPS 信和 号， 就 会 自动 切换 到 GPS 定位 模式 了 。 


当然 我 们 也 可 以 强制 指定 只 使 用 GPS 进行 定位 ， 修 改 MainActivity 中 的 
代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 








priva es oid + ati on 
Lo a on clis 0 option = new LocationClientOption(); 
i ); 
option.setLocationMode(LocationClientOption.LocationMode.Device_ Sensors); 
mLocationClient.setLocOption(option); 








这 里 调用 了 setLocationMode( ) 方 法 来 将 定位 模式 指 定 成 传感器 模式 ， 也 
就 是 说 只 能 使 用 GPS 进行 定位 。 重 新 运行 一 下 程序 ， 然 后 拿 着 你 的 手机 
走 到 室外 去 ， 结 果 如 网 11.20 所 示 。 
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图 11.20 GPS 定位 的 结果 
11.3.4 看 得 懂 的 位 置信 息 


话说 回来 ， 刚 才 我 们 虽然 成 功 获取 到 了 设备 当前 位 置 的 经 纬度 信息 ， 但 
遗憾 的 是 ， 这 种 经 纬度 的 值 一 般 人 是 根本 看 不 懂 的 ， 相 信 谁 也 无 法 立刻 
答 出 南 纬 25 度 、 东 经 148 度 是 什么 地 方 吧 ? 为 了 能 够 更 加 直观 地 阅读 ， 
我 们 还 需要 学 习 一 下 如 何 获 取 看 得 懂 的 位 置信 息 。 


幸运 的 是 ， 百 度 LBS SDK 在 这 方面 提供 了 非常 好 的 支持 ， 我 们 只 需要 进 
行 一 些 简 日 的 接口 调用 就 能 得 到 当前 位 置 各 种 丰富 的 地 址 信息 ， 下 面 就 
来 一 起 看 一 下 吧 。 











修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private void initLocation(){ 
LocationCclientoption option = new LocationCclientOption(); 
option.setscanspan(5000); 
option.setIsNeedAddress(true); 
mLocationClient.setLocOoption(option); 


public class MyLocationListener implements BDLocationListener { 


@Override 
public void onReceiveLocation(BDLocation location) { 
runonUiThread(new Runnable() { 
@Override 
public void run() { 
StringBuilder currentPosition = new StringBuilder(); 
currentPosition.append(" 纬 度 : ") .append(location.getLatitude() ) . 
append("\n"); 
currentPosition.append( "经线 : ").append(location.getLongitude()). 
append("\n"); 
currentPosition.append(" 国 家 : ") .append(location.getCountry() ) . 
append("\n"); 
currentPosition.append(" 省 : ").append(location.getProvince()). 
append("\n"); 
currentPosition.append(" 市 : ") .append(location.getCity() ) . 
append("\n"); 
currentPosition.append(" 区 : ").append(location.getDistrict()). 
append("\n"); 
currentPosition.append( "街道 : ").append(location.getStreet()). 
append("\n"); 
currentPosition.append(" 定 位 方式 :"); 
if (location.getLocType() == BDLocation.TypeGpsLocation) { 
currentPosition.append("GPS"); 
} else if (location.getLocType() == 
BOLOCation TyneNeTtwot ki ocet on { 
currentPosition.append(" 网 络 ") ; 

















positionText .SetText(currentPosition) 


}); 


首先 在 initLocation() 方 法 中 ， 我 们 调用 了 LocationClientOption 的 
| 并 传 入 true， 这 就 表示 我 们 需要 获取 当前 位 
置 详细 的 地 址 信息 。 


接 下 来 在 MyLocationListener 的 onReceiveLocation() 方 法 怠 可 以 获取 到 
各 种 丰富 的 地 址 信息 了 ， 调 用 getcountry() 方 法 可 以 得 到 当前 所 在 国 
家 ， 调用 getProvince() 方 法 可 以 得 到 当前 所 在 省 份 ， 以 此 类 推 。 另 外 
还 有 一 点 需要 注意 ， 由 于 获取 地 址 信息 一 定 需要 用 到 网 络 ， 因此 即使 我 
们 将 定位 模式 指定 成 了 Device_Sensors， 也 会 自动 开启 网 络 定位 功能 。 


现在 重新 运行 一 下 程序 ， 结 果 如 图 11.21 所 示 。 
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图 11.21 获取 到 当前 位 置 的 地 址 信息 


可 以 看 到 ， 手 机 当前 位 置 的 地 址 信息 已经 成 功 显 示 出 来 了 。 如 果 你 市 着 
手机 移动 了 较 远 的 距离 ， 界 面 上 显示 的 位 置 也 会 跟着 一 起 变化 的 。 





11.4 ”使 用 百 虐 地 图 


现在 手机 地 图 的 应 用 真 的 可 以 算得 上 是 非常 广泛 了 ， 和 PC 上 的 地 图 相 
比 ， 手 机 地 图 能 够 随时 随地 进行 查看， 并且 轻松 构建 出 行路 线 ， 使 用 起 
来 明显 更 加 地 方便 。 但 是 你 有 没有 想 过 ， 其 实 我 们 在 自己 的 应 用 程序 里 
也 是 可 以 加 入 地 图 功能 的 ， 比 如 优 步 中 使 用 的 就 是 百度 地 图 。 本 市 我 们 
就 来 学 习 一 下 这 方面 的 知识 。 


11.4.1 让 地 图 显示 出 来 


由 于 在 上 一 节 中 我 们 已 经 将 LBS SDK 全 部 准备 好 了 ， 其 中 就 包括 了 地 图 
功能 ， 因 此 这 里 就 不 用 再 去 下 载 百 度 地 图 的 SDKJ。 


那么 我 们 直接 在 LBSTest 项 目的 基础 上 进行 开发 ， 修 改 activity_main.xml 
中 的 代码 ， 如 下 所 示 : 


mlns:android="http://schemas.android.com/apk/res/android" 

















<LinearLayou 





这 里 在 布局 文件 中 新 放置 了 一 个 MapView 控 件 ， 并 让 它 填 充满 整个 屏 
幕 。 这 个 MapView 是 由 百度 提供 的 目 定义 控件 ， 所 以 在 使 用 它 的 时 候 需 
要 将 完整 的 包 名 加 上 。 男 外 ， 之 前 用 于 显示 定位 信息 的 TextView 现 在 暂 
Wi 我 们 将 它 的 visibility 属 性 指定 成 gone， 让 它 在 界面 上 隐 
藏 起 来 。 


接 下 来 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 





private MapView mapView; 


@override 

protected void onCreate(Bundle SavedInstanceState) { 
super .onCreate(savedInstanceState); 
mLocationClient = new LocationClient(getApplicationContext()); 
mLocationClient.registerLocationListener(new MyLocationListener()); 
SDKInitializer.initialize(getApplicationContext()); 
setContentView(R.1layout.activity_main); 
mapView = (MapView) findViewById(R.id.bmapView); 


} 


@override 

protected void onResume() { 
super .onResume( ); 
mapView.onResume( ); 


} 


@override 

protected void onPause() { 
super .onPause(); 
mapView.onPause(); 


} 


@Ooverride 

protected void onDestroy() { 
super .onDestroy(); 
mLocationClient.stop(); 
mapView.onDestroy(); 


} 


可 以 看 到 ， 这 里 的 代码 也 非常 简单 。 首 先 需 要 调用 SDKInitializer 的 
initialize() 方 法 来 进行 初始 化 操作 ，initialize() 方 法 接收 一 

个 context 参 数 ， 这 里 我 们 调用 getApplicationcontext() 方 法 来 获取 一 
个 全 局 的 context 参 数 并 传 入 。 注 意 初 始 化 操作 一 定 要 

在 setcontentView() 方 法 前 调用 ， 不 然 的 话 束 会 出 错 。 接 下 来 我 们 调 
用 findviewById() 方 法 获取 到 了 MapView 的 实例 ， 这 个 实例 在 后 面 的 功 
能 当中 还 会 用 到 。 


另外 还 需要 重 写 onResume()、onPause() 和 onDestroy() 这 3 个 方法 ， 在 这 
里 对 MapView 进 行 管理 ， 以 保证 资源 能 够 及 时 地 得 到 释放 。 


好 了 ， 就 是 这 么 简单 。 现 在 重新 运行 一 下 程序 ， 百 度 地 图 就 应 该 成 功 显 
示 出 来 了 ， 如 图 11.22 所 示 。 
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图 11.22 让 百度 地 图 显示 出 来 
11.4.2 移动 到 我 的 位 置 


地 图 是 成 功 显示 出 来 了 ， 但 也 许 这 并 不 是 你 想 要 的 。 因 为 这 是 一 张 默认 
的 地 图 ， 显 示 的 是 北 泵 市 中 心 的 位 置 ， 而 你 可 能 希望 看 到 更 加 精细 的 地 
图 信息 ， 比 如 说 目 己 所 在 位 置 的 周边 环境 。 显 然 ， 通 过 缩放 和 移动 的 方 
式 来 慢 慢 找到 上 自己 的 位 置 是 一 种 很 加 厌 的 做 法 。 那 么 本 小 节 我 们 就 来 学 
习 一 下 ， 如 何 才能 在 地 图 中 快速 移动 到 自己 的 位 置 。 


百度 LBS SDK 的 API 中 提供 了 一 个 BaiduMap 类 ， 它 是 地 图 的 总 控制 器 ， 











调用 MapView 的 getMap() 方 法 就 能 获取 到 BaiduMap 的 实例 ， 如 下 所 示 : 


BaiduMap baiduMap = mapView.getMap(); 


有 了 BaiduMap 后 ， 我 们 就 能 对 地 图 进行 各 种 各 样 的 操作 了， 比如 设置 
地 图 的 缩放 级 别 以 及 将 地 图 移动 到 某 一 个 经 纬度 上 。 


百度 地 图 将 缩放 级 别 的 取 值 范围 限定 在 3 到 19 之 间 ， 其 中 小 数 点 位 的 值 
也 是 可 以 取 的 ， 值 越 大 ， 地 图 显示 的 信息 就 越 精 细 。 比 如 我 们 想 要 将 缩 
放 级 别 设置 成 12.5， 就 可 以 这 样 写 : 


MapStatusUpdate update = MapStatusUpdateFactory.zoomTo(12.5f); 
baiduMap.animateMapStatus(update); 


其 中 MapStatusUpdateFactory 的 zoomTo() 方 法 接收 一 个 float 型 的 参数 ， 
就 是 用 于 设置 缩放 级 别 的 ， 这 里 我 们 传 入 12.5f。zoomTo() 方 法 返回 一 
个 MapstatusUpdate 对 象 ， 我 们 把 这 个 对 象 传 入 BaiduMap 的 
animateMapStatus( ) 方 法 当 中 即 可 完成 缩放 功能 。 


那么 怎样 才能 让 地 图 移动 到 菏 一 个 经 纬度 上 昵 ? 这 就 需要 借助 LatLng 类 
了 。 其 实 LatLng 并 没有 什么 太 多 的 用 法 ， 主 要 就 是 用 于 存放 经 纬度 值 
的 ， 它 的 构造 方法 接收 两 个 参数 ， 第 一 个 参数 是 纬度 值 ， 第 二 个 参数 是 
经 上 度 值 。 之 后 调用 MapStatusUpdateFactory 的 newLatLng() 方 法 将 LatLng 
对 象 传 入 ，newLatLng() 方 法 返回 的 也 是 一 个 MapstatusUpdate 对 象 ， 我 
们 再 把 这 个 对 象 传 入 BaiduMap 的 animateMapstatus() 方 法 当中 ， 束 可 以 
将 地 图 移动 到 指定 的 经 纬度 上 了 ， 写 法 如 下 : 








LatLng 11 = new LatLng(39.915, 116.404); 
MapStatusUpdate update = MapStatusUpdateFactory.newLatLng(11); 
baiduMap.animateMapStatus(update); 


上 述 代 码 就 实现 了 将 地 图 移动 到 北纬 39.915 度 、 东 经 116.404 度 这 个 位 置 
的 功能 。 


了 解 了 这 些 知 识 之 后 ， 接 下 来 再 去 实现 将 地 图 快速 移动 到 目 己 位 置 的 功 
能 束 变 得 非常 简单 了 。 首 先 我 们 可 以 利用 在 11.3 节 中 所 学 的 定位 技术 来 
获得 自己 当前 位 置 的 经 纬度 ， 之 后 再 按照 上 述 的 方法 来 将 地 图 移动 到 指 
定 的 位 置 就 可 以 了 。 














那么 下 面 我 们 就 来 继续 完善 LBSTest 这 个 项 目 ， 加 入 “移动 到 我 的 位 
置 ” 这 个 功能 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private BaiduMap baiduMap; 
private boolean isFirstLocate = true; 


@override 

protected void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
mLocationClient = new LocationClient(getApplicationContext()); 
mLocationClient.registerLocationListener(new MyLocationListener()); 
SDKInitializer.initialize(getApplicationContext()); 
setContentView(R.1layout.activity main); 
mapView = (MapView) findViewById(R.id.bmapView); 
baiduMap = mapView.getMap(); 


} 


private void navigateTo(BDLocation location) { 
if (isFirstLocate) { 
LatLng 11 = new LatLng(location.getLatitude(), location.getLongitude()); 
MapStatusUpdate update = MapStatusUpdateFactory.newLatLng(11); 
baiduMap.animateMapStatus(update); 
update = MapStatusUpdateFactory.zoomTo(16f); 
baiduMap .animateMapStatus(update ) ; 
isFirstLocate = false; 
} 
} 


public class MyLocationListener implements BDLocationListener { 


@override 
public void onReceiveLocation(BDLocation location) { 
if (location.getLocType() == BDLocation.TypeGpsLocation 
|| location.getLocType() == BDLocation.TypeNetworkLocation) { 
navigateTo(location); 





这 里 并 没有 新 增多 少 代码 ， 主 要 是 加 入 了 一 个 navigateTo() 方 法 。 这 个 
方法 中 的 代码 也 很 好 理解 ， 先 是 将 BpbLocation 对 象 中 的 地 理 位 置信 息 取 
出 并 封装 到 LatLng 对 象 中 ， 然 后 调用 MapStatusUpdateFactory 的 
newLatLng () 方 法 并 将 LatLng 对 象 传 入 ， 接 着 将 返回 的 MapStatusUpdate 
对 象 作为 参数 传 入 到 BaiduMap 的 animateMapstatus() 方 法 当中 ， 和 上 面 
介绍 的 用 法 是 一 模 一 样 的 。 并 且 这 里 为 了 让 地 图 信息 可 以 显示 得 更 加 丰 
富 一 些 ， 我 们 将 缩放 级 别 设置 成 了 16。 另外 还 有 一 点 需要 注意 ， 上 述 代 
码 当中 我 们 使 用 了 一 个 isFirstLocate 变 量 ， 这 个 变量 的 作用 是 为 了 防 
止 多 次 调用 animateMapstatus() 方 法 ， 因为 将 地 图 移动 到 我 们 当前 的 位 
置 只 需要 在 程序 第 一 次 定位 的 时 候 调 用 一 次 就 可 以 了 。 


写 好 了 navigateTo() 方 法 之 后 ， 剩 下 的 事情 就 简单 了 ， 当 定位 到 设备 当 
前 位 置 的 时 候 ， 我 们 在 onReceiveLocation( ) 方 法 中 直接 把 BDLocation 对 
象 传 给 navigateTo() 方 法 ， 这 样 就 能 够 让 地 图 移动 到 设备 所 在 的 位 置 
各 











现在 重新 运行 一 下 程序 ， 结 果 如 图 11.23 所 示 。 
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图 11.23 将 地 图 移动 到 设备 所 在 的 位 置 
11.4.3 ”让 “我 ”显示 在 地 图 上 


现在 我 们 已 经 可 以 让 地 图 显示 我 们 周边 的 环境 了 ， 但 是 相信 在 你 平时 使 
用 手机 地 图 时 应 该 会 注意 到 ， 通 常情 况 下 手机 地 图 上 应 该 都 会 有 一 个 小 
光标 ， 用 于 显示 设备 当前 所 在 的 位 置 ， 并 且 如 果 设 备 正在 移动 的 话 ， 那 
么 这 个 光标 也 会 跟着 一 起 移动 。 那 么 我 们 现在 就 继续 对 现 有 代码 进行 扩 
展 ， 让 “我 ”能够 显示 在 地 图 上 。 








百度 LBS SDK 当 中 提供 了 一 个 MyLocationData.Builder 类 ， 这 个 类 是 用 
来 封装 设备 当前 所 在 位 置 的， 我 们 只 需 将 经 纬度 信息 传 入 到 这 个 类 的 相 
应 方法 当中 就 可 以 了 ， 如 下 所 示 : 

MyLocationData.Builder locationBuilder = new MyLocationData.Builder() 


JocationBuilder. Latitude(39.915) ; 
JocationBuilder. Longitude(116.404) 


MyLocationData.Builder 类 还 提供 了 一 个 build() 方 法 ， 当 我 们 把 要 封装 
的 信息 都 设置 完成 之 后 ， 只 需要 调用 它 的 build() 方 法 ， 束 会 生成 一 个 
MyLocationData 的 实例 ， 然 后 再 将 这 个 实例 传 入 到 BaiduMap 的 
setMyLocationDatal ) 方 ;二 当 中 ;了 可 以 让 设备 当 前 的 位 置 显示 在 地 图 上 
了 人 


MyLocationData locationData = locationBuilder .build(); 
baiduMap.setMyLocationData(locationData); 





大 体 思 路 就 是 这 个 样子 ， 下 面 我 们 开始 来 实现 一 下 ， 修 改 MainActivity 
中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
mLocationClient = new LocationClient(getApplicationContext()); 
mLocationClient.registerLocationListener(new MyLocationListener()); 
SDKInitializer.initialize(getApplicationContext()); 
setContentView(R.1layout.activity main); 
mapView = (MapView) findViewById(R.id.bmapView); 
baiduMap = mapView.getMap(); 
baiduMap.setMyLocationEnabled(true); 


} 


private void navigateTo(BDLocation location) { 
if (isFirstLocate) { 





LatLng 11 = new LatLng(location.getLatitude(), location.getLongitude()); 
MapStatusUpdate update = MapStatusUpdateFactory.newLatLng(11); 
baiduMap.animateMapStatus(update); 
update = MapStatusUpdateFactory.zoomTo(16f); 
baiduMap .animateMapStatus(update) ; 
isFirstLocate = false; 
} 
MyLocationData.Builder locationBuilder = new MyLocationData.Builder(); 
locationBuilder.latitude(location.getLatitude()); 
locationBuilder.longitude(location.getLongitude()); 
MyLocationData locationData = locationBuilder .build(); 
baiduMap.setMyLocationData(locationData); 


} 


@Override 

protected void onDestroy() { 
super .onDestroy(); 
mLocationClient.stop(); 
mapView.onDestroy(); 
baiduMap.setMyLocationEnabled(false); 

} 


可 以 看 到 ， 在 navigateTo() 方 法 中 ， 我 们 添加 了 MyLocationData 的 构建 
逻辑 ， 将 Location 中 包含 的 经 度 和 纬度 分 别 封 装 到 了 
MyLocationData.Builder 当 中 ， 最 后 把 MyLocationData 设 置 到 了 BaiduMap 
的 setMyLocationData() 方 法 当中 。 注 意 这 段 逻 辑 必 须 写 

在 isFirstLocate 这 个 话 条 件 语句 的 外 面 ， 因 为 让 地 图 移动 到 我 们 当前 的 
位 置 只 需要 在 第 一 次 定位 的 时 候 执 行 ， 但 是 设备 在 地 图 上 显示 的 位 置 却 
应 该 是 随 着 设备 的 移动 而 实时 改变 的 。 


另外 ， 根 据 百 度 地 图 的 限制 ， 如 果 我 们 想 要 使 用 这 一 功能 ， 一 定 要 事先 
调用 BaiduMap 的 setMyLocationEnabled() 方 法 将 此 功能 开启， 否则 设备 
的 位 置 将 无 法 在 地 图 上 显示 。 而 在 程序 退出 的 时 候 ， 也 要 记得 将 此 功能 
给 关闭 抒 。 


就 是 这 么 简单 ， 现 在 重新 运行 一 下 程序 ， 结 果 如 图 11.24 所 示 。 
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图 11.24 让 “我 ”显示 在 地 图 上 
这 样 的 话 ， 用 户 就 可 以 非常 清晰 地 看 出 自己 当前 是 在 哪里 了 。 


关于 百度 LBS SDK 的 用 法 我 就 准备 介绍 这 么 多 ， 现 在 你 已 经 算是 成 功 入 
门 了 。 如 果 想 要 更 加 深入 地 研究 百度 LBS 的 各 种 用 法 ， 可 以 到 官方 网 站 
上 面 参考 开发 指南 ， 地 址 是 : http:/lbsyun.baidu.com。 另 外 ， 百 度 LBS 
SDK 的 版 本 未 来 随时 都 有 可 能 更 新 ， 也 许 更 新 之 后 会 导致 书 上 的 例子 无 
法 正常 运行 ， 因 此 除了 照 着 图 书 学 习 之 外 ， 根 据 官网 的 开发 指南 来 进行 
学 习 也 是 非常 重要 的 ， 因 为 官方 文档 永远 都 是 最 新 的 。 


好 了 ， 本 章 的 主体 内 容 到 这 里 就 结束 了。 下 面 我 们 将 再 次 进入 本 书 的 特 





殊 环 节 ， 学 习 一 下 关于 Git 的 高 级 用 法 。 





11.5。” ”Git 时间 版 本 控制 工具 的 高 
级 用 法 

现在 的 你 对 于 Git 应 该 完全 不 会 感到 卫生 了 吧 ， 通 过 了 之 前 两 节 内 容 的 
学 习 ， 你 已 经 掌握 了 很 多 Git 中 常用 的 命令 ， 像 提交 代码 这 种 简单 的 操 
作 相 信 肯 定 是 难 不 倒 你 的 。 


0 0 
六 和 上 : 








ee 下 面 就 让 我 们 开始 学 习 关 于 Git 的 高 级 用 
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11.5.1 分 支 的 用 法 


分 支 是 版 本 控制 工具 中 比较 高 级 且 比较 重要 的 一 个 概念 ， 它 主要 的 作用 

就 是 在 现 有 代码 的 基础 上 开辟 一 个 分 叉 口 ， 使 得 代码 可 以 在 主干 线 和 分 

人 
11.25 所 不 。 











分 文 线 


TT 各 


( ) 表示 一 次 提交 


图 11.25 分 支 的 工作 原理 示意 图 


你 也 许 会 有 疑惑 ， 为 什么 需要 建立 分 支 呢 ? 只 在 主干 线 上 进行 开发 不 是 
挺 好 的 吗 ? 没 错 ， 通 常情 况 下 ， 只 在 主干 线 上 进行 开发 是 完全 没有 问题 
的 ， 不 过 一 旦 涉及 出 版 本 的 情况 ， 如 果 不 建立 分 文 的 话 ， 你 就 会 非常 地 
头疼 。 举 个 简单 的 例子 吧 ， 比 如 说 你 们 公司 研发 了 一 球 不 错 的 软件 ， 最 
近 刚 刚 完 成 ， 并 推出 了 1.0 版 本 。 但 是 领导 是 不 会 让 你 们 朵 着 的 ， 马 上 
提出 了 新 的 需求 ， 让 你 们 投入 到 了 1.1 版 本 的 开发 工作 当中 。 过 了 几 个 
星期 ,1.1 版 本 的 功能 已 完成 了 一 半 ， 但 是 这 个 时 候 有 用 户 反 馈 ， 之 前 
上 线 的 1.0 版 本 发 现 了 几 个 重大 的 pug， 严 重 影响 软件 的 正常 使 用 。 领 导 
也 相当 重视 这 个 问题 ， 要 求 你 们 立刻 修复 这 些 pug， 并 重新 发 布 1.0 版 
本 ， 但 这 个 时 候 你 束 非 第 为 难 了 ， 你 会 友 现 根本 没 法 去 修复 这 些 bug。 
因为 现在 1.1 版 本 已 开发 一 半 了 ， 如 果 在 现 有 代码 的 基础 上 修复 这 些 
bug， 那 么 更 新 的 1.0 版 本 将 会 带 有 一 半 1.1 厂 本 的 功能 ! 


进退 两 难 了 是 不 是 ? 但 是 如 果 你 使 用 了 分 文 的 话 ， 就 完全 不 会 存在 这 个 
让 人 头疼 的 问题 。 你 只 需要 在 发 布 1.0 版 本 的 时 候 建立 一 个 分 支 ， 然 后 
在 主干 线 上 继续 开发 1.1 版 本 的 功能 。 当 1.0 版 本 上 发 现任 何 bug 的 时 候 ， 
就 在 分 支线 上 进行 修改 ， 然 后 及 布 新 的 1.0 版 本 ， 并 记得 将 修改 后 的 代 
码 合 并 到 主干 线 上 。 这 样 的 话 ， 不 仅 可 以 轻松 解决 掉 1.0 版 本 存在 的 
bug， 而 且 保证 了 主干 线 上 的 代码 也 已 经 修复 了 这 些 bug， 当 1.1 版 本 发 
布 时 就 不 会 有 同样 的 bug 存 在 了 。 


说 了 这 么 多 ， 相 信 你 也 已 经 意识 到 分 支 的 重要 性 了 ， 那 么 我 们 马上 来 学 
习 一 下 如 何在 Git 中 操作 分 支 吧 。 


分 文 的 英文 名 是 branch， 如 果 想 要 查看 当前 的 版 本 库 当 中 有 哪些 分 文 ， 
可 以 使 用 git branch 这 个 命令 ， 结 果 如 图 11.26 所 示 。 






































图 11.26 但 看 所 有 分 文 


由 于 目前 LBSTest 项 目 中 还 没有 创建 过 任何 分 文 ， 因 此 只 有 一 个 master 
ee 
?9 HH 亲信 0D 下 : 


git branch version1.0 








这 样 就 创建 了 一 个 名 为 version1.0 的 分 文 ， 我 们 再 次 输入 git branch 这 个 
命令 来 检查 一 下 ， 结 果 如 图 11.27 所 示 。 


$ git branch 


versioni1.0 


图 11.27 ”再 次 查看 所 有 分 文 


可 以 看 到 ， 果 然 有 一 个 叫 作 version1.0 的 分 支出 现 了 。 你 会 发 现 ，master 
分 文 的 前 面 有 一 个 “*” 写 ， 说 明 目 前 我 们 的 代码 还 是 在 master 分 文 上 的 ， 
那么 怎样 才能 切换 到 version1.0 这 个 分 文 上 呢 ? 其 实 也 很 简单 ， 只 需要 使 
用 checkout 命 令 即 可 ， 如 下 所 示 : 


git checkout version1.0 





再 次 输入 git branch 来 进行 检查 ， 结 果 如 图 11.28 所 示 。 


$ git branch 





master 


图 11.28 ”查看 切换 分 支 后 的 结果 
可 以 看 到 ， 我 们 已 经 把 代码 成 功 切换 到 version1.0 这 个 分 文 上 了 。 


需要 注意 的 是 ， 在 version1.0 分 文 上 修改 并 提交 的 代码 将 不 会 影响 到 
master 分 文 。 同 样 的 道理 ， 在 master 分 文 上 修改 并 提交 的 代码 也 不 会 影 
啊 到 version1.0 分 文 。 因 此 ， 如 果 我 们 在 version1.0 分 文 上 修复 了 一 个 
bug， 在 master 分 文 上 这 个 bug 仍 然 是 存在 的 。 这 时 将 修改 的 代码 一 行 行 
复制 到 master 分 文 上 显然 不 是 一 种 聪明 的 做 法 ， 最 好 的 办 法 就 是 使 

用 merge 命 令 来 完成 合并 操作 ， 如 下 所 示 : 


git checkout master 
git merge version1.0 


仅仅 这 样 简 单 的 两 行 命令 ， 就 可 以 把 在 version1.0 分 支 上 修改 并 提交 的 内 
容 合 并 到 master 分 文 上 了 。 当 然 ， 在 合并 分 文 的 时 候 还 有 可 能 出 现代 码 
冲突 的 情况 ， 这 个 时 候 你 就 需要 静 下 心 来 慢 慢 地 找 出 并 解决 这 些 冲 突 ， 
Git 在 这 里 束 无 法 帮助 你 了 。 


最 后 ， 当 我 们 不 再 需要 version1.0 这 个 分 支 的 时 候 ， 可 以 使 用 如 下 命令 将 
这 个 分 文 删除 扼 : 


git branch -D version1.0 





11.5.2 与 远程 版 本 库 协作 


可 以 这 样 说， 如 条 你 是 一 个 人 在 开发 ， 那 么 使 用 版 本 控制 工具 就 远 远 无 
法 发 挥 出 它 真 正 强 大 的 功能 。 疫 错 ， 所 有 版 本 控制 工具 最 重要 的 一 个 特 
点 就 是 可 以 使 用 它 来 进行 团队 合作 开发 。 每 个 人 的 电脑 上 都 会 有 一 份 代 
码 ， 当 团队 的 茶 个 成 员 在 目 己 的 电脑 上 编写 完成 了 某 个 功能 后 ， 就 将 代 
码 提交 到 服务 器 ， 其 他 的 成 员 只 需要 将 服务 右上 的 代码 同步 到 本 地 ， 束 
能 保证 整个 团队 所 有 人 的 代码 都 相同 。 这 样 的 话 ， 每 个 团队 成 员 就 可 以 
各 司 其 职 ， 大 家 共同 来 完成 一 个 较为 庞大 的 项 目 。 


那么 如 何 使 用 Git 来 进行 团队 合作 开发 呢 ? 这 就 需要 有 一 个 远程 的 版 本 
库 ， 团 队 的 每 个 成 员 都 从 这 个 版 本 库 中 获取 到 最 原始 的 代码 ， 然 后 各 目 
进行 开发 ， 并 且 以 后 每 次 提交 的 代码 都 同步 到 远程 版 本 库 上 就 可 以 了 。 
为 外 ， 团 队 中 的 每 个 成 员 最 好 都 要 养 成 经 党 从 版 本 库 中 获取 最 新 代码 的 
习惯 ,不然 的 话 ， 大 家 的 代码 就 很 有 可 能 经 第 出 现 冲突 。 


比如 说 现在 有 一 个 远程 版 本 库 的 Git 地 址 
是 https://github.com/example/test.git， 就 可 以 使 用 如 下 的 命令 将 代码 下 载 
到 本 地 : 


git clone https://github.com/example/test.git 















































之 后 你 在 这 份 代码 的 基础 上 进行 了 一 些 修改 和 提交 ， 那 么 怎样 才能 把 本 
地 修改 的 内 容 同步 到 远程 版 本 库 上 了 呢 ? 这 就 需要 借助 push 命 令 来 完成 
了 ， 用 法 如 下 所 示 : 


git push origin master 








其 中 origin 部 分 指定 的 是 远程 版 本 库 的 Git 地 址 ，master 部 分 指定 的 是 同 
步 到 哪 一 个 分 文 上 ， 上 述 命令 束 完 成 了 将 本 地 代码 同步 
到 https://github.com/example/test.git 这 个 版 本 库 的 master 分 支 上 的 功能 。 


知道 了 将 本 地 的 修改 同步 到 远程 版 本 库 上 的 方法 ， 接 下 来 我 们 看 一 下 如 
何 将 远程 版 本 库 上 的 修改 同步 到 本 地 。Git 提 供 了 两 种 命令 来 完成 此 功 
能 ， 分 别 是 fetch 和 pul1，fetch 的 语法 规则 和 push 是 差不多 的 ， 如 下 所 
砂 : 


git fetch origin master 


执行 这 个 命令 后 ， 就 会 将 远程 版 本 库 上 的 代码 同步 到 本 地 ， 不 过 同步 下 
来 的 代码 并 不 会 合并 到 任何 分 文 上 去 ， 而 是 会 存放 到 一 

个 origin/master 分 文 上 ， 这 时 我 们 可 以 通过 diff 命 令 来 查看 远程 版 本 库 
上 到 底 修 改 了 哪些 东西 : 


git diff origin/master 








之 后 再 调用 merge 命 令 将 origin/master 分 支 上 的 修改 合并 到 主 分 支 上 即 
可 ， 如 下 所 示 : 


git merge origin/master 


而 pull 命 令 则 是 相当 于 将 fetch 和 merge 这 两 个 命令 放 在 一 起 执行 了 ， 它 可 
以 从 远程 版 本 库 上 获取 最 新 的 代码 并 且 合 并 到 本 地 ， 用 法 如 下 所 示 : 


git pull origin master 








也 许 你 现在 对 远程 版 本 库 的 使 用 还 是 感觉 比较 抽象 ， 没 关系 ， 因 为 暂时 
我 们 只 是 了 解 了 一 下 命令 的 用 法 ， 还 没 进行 实践 ， 在 第 14 章 当中 ， 你 将 
会 对 远程 版 本 库 的 用 法 有 更 深 一 层 的 认识 。 











11.6 ”小 结 与 点 评 


不 得 不 说 ， 本 章 中 学 到 的 知识 应 该 还 算是 蛮 有 趣 的 吧 ?” 在 这 次 的 
Android 特 色 开 发 环节 中 ， 我 们 主要 学 习 了 基于 位 置 服务 的 工作 原理 和 
用 法 ， 借 助 百 度 提供 的 LBS SDK， 我 们 可 以 随时 确定 自己 当前 位 置 的 经 
纬度 ， 并 且 还 能 获取 到 有 具体 的 省 、 市 、 区 、 街 道 等 地 址 。 之 后 又 学 习 了 
百度 地 图 的 用 法 ， 不 仅 成 功 地 将 地 图 信息 显示 了 出 来 ， 还 综合 利用 了 前 
面 所 学 到 的 定位 技术 实现 了 一 个 较为 完整 的 例子 。 


除了 基于 位 置 的 服务 之 外 ， 本 章 Git 时 间 中 继续 对 Git 的 用 法 进行 了 更 深 
0 0 0 
符 。 

那么 关于 Android 特 色 开 发 的 内 容 就 讲 到 这 里 ， 下 一 章 中 我 们 将 会 学 习 
Android 5.0 系 统 中 新 增 的 一 套 全 新 的 知识 点 一 一 Material Design。 




















第 12 章 最 佳 的 UI 体 验 一 -Material 
Design 实 战 


其 实 长 久 以 来 ， 大 多 数 人 都 认为 Android 系 统 的 UI 并 不 算 美 观 ， 至 少 没 

有 iOS 系 统 的 美观 。 以 至 于 很 多 I 开 公司 在 进行 应 用 界面 设计 的 时 候 ， 为 

了 保证 双 平台 的 统一 性 ， 强 制 要 求 Android 端 的 界面 风格 必须 和 iOS 端 一 
致 。 这 种 情况 在 现实 工作 当中 实在 是 太 常 见 了 ， 虽 然 我 认为 这 是 非常 不 
合理 的 。 因 为 对 于 一 般 用 户 来 说 ， 他 们 不 太 可 能 会 在 两 个 操作 系统 上 分 
别 去 使 用 同一 个 应 用 ， 但 是 却 必定 会 在 同一 个 操作 系统 上 使 用 不 同 的 应 
用 。 因 此 ， 同 一 个 操作 系统 中 各 个 应 用 之 间 的 界面 统一 性 要 远 比 一 个 应 
人 
J 用 尸体 堆 。 


但 问题 在 于 ，Android 标 准 的 界面 设计 风格 并 不 是 特别 被 大 众 所 接 受 ， 
很 多 公司 都 觉得 自己 完全 可 以 设计 出 更 加 好 看 的 界面 ， 从 而 导致 
Android 平 台 的 界面 风格 长 期 难以 得 到 统一 。 为 了 解决 这 个 问题 ， 谷 歌 
也 是 祭 出 了 杀手 铜 ， 在 2014 年 Google IO 大 会 上 重 磅 推出 了 一 套 全 新 的 
界面 设计 语言 一 -Material Design。 


本 章 我 们 就 将 对 Material Design 进 行 一 次 深入 的 学 习 。 

















12.1 什么 是 Material Design 


Material Design 是 由 谷歌 的 设计 工程 师 们 基于 传统 优秀 的 设计 原则 ， 疆 
合 丰 襄 的 创意 和 科学 技术 所 发 明 的 一 僚 全 新 的 界面 设计 语言 ， 包 含 了 视 
觉 、 运 动 、 互 动 效 末 等 特性 。 那 么 谷歌 任 什 么 认为 Material Design 就 能 
解决 Android 平 台 界 面 风格 不 统一 的 问题 昵 ? 一 言 以 英之 ， 好 看 ! 


没 错 ， 这 次 谷歌 在 界面 设计 上 确实 是 下 足 了 功夫 ， 很 多 媒体 评论 ， 
Material ”Design 的 出 现 使 得 Android 首 次 在 UI 方面 超越 了 iOS。 按 照 正常 
的 思维 来 想 ， 如 果 各 个 公司 都 无 法 设计 出 比 Material Design 更 出 色 的 界 
面 风格 ， 那 么 它们 就 应 该 理所当然 地 使 用 Material Design 来 设计 界面 ， 
从 而 也 束 能 解决 Android 平 台 界 面 风 格 不 统一 的 问题 了 。 


为 了 做 出 表率 ， 谷 歌 从 Android 5.0 系 统 开 始 ， 就 将 所 有 内 置 的 应 用 都 使 
用 Material Design 风 格 来 进行 设计 。 这 里 我 随便 截 了 两 张 图 ， 你 可 以 先 
欣赏 一 下 ， 如 图 12.1 所 示 。 
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图 12.1 使 用 Material Design 设 计 的 应 用 


其 中 ， 左 边 的 应 用 是 Play Store， 右 边 的 应 用 是 YouTube。 可 以 看 出 ， 它 
们 的 界面 都 十 分 美观 ， 而 它们 正 是 使 用 Material Design 来 进行 设计 的 。 


不 过 ， 在 重 磅 推出 之 后 ，Material Design 的 普及 程度 却 不 能 说 是 特别 理 
想 。 因 为 这 只 是 一 个 推荐 的 设计 规范 ， 主 要 是 面 同 UI 设计 人 员 的 ， 而 不 
是 面 同 开发 者 的 。 很 多 开发 者 可 能 根本 就 搞 不 清楚 什么 样 的 界面 和 效果 
才 叫 Material Design， 就 算 搞 清楚 了， 实现 起 来 也 会 很 费劲 ， 因 为 不 少 
Material Design 的 效果 是 很 难 实现 的 ， 而 Android 中 却 几 乎 没有 提供 相应 
的 API 文 持 ， 一 切 都 要 靠 开 发 者 自己 从 零 写 起 。 





谷歌 当然 也 意识 到 了 这 个 问题 ， 于 是 在 2015 年 的 Google VO 大 会 上 推出 
了 一 个 Design Support 库 ， 这 个 库 将 Material Design 中 最 具 代 表 性 的 一 些 
控件 和 效果 进行 了 封装 ， 使 得 开发 者 在 即使 不 了 解 Material Design 的 情 
况 下 也 能 非常 轻松 地 将 自己 的 应 用 Material 化 。 本 章 中 我 们 就 将 对 
Design ”Support 这 个 库 进 行 深入 的 学 习 ， 并 且 配 合 一 些 其 他 的 控件 来 完 
成 一 个 优秀 的 Material Design 应 用 。 


新 建 一 个 MaterialTest 项 目 ， 然 后 我 们 马上 开始 吧 ! 


12.2 Toolbar 


Toolbar 将 会 是 我 们 接触 的 第 一 个 Material 控 件 。 虽 说 对 于 Toolbar 你 暂时 
应 该 还 是 比较 陌生 的 ， 但 是 对 于 它 的 另 一 个 相关 控件 ActionBar， 你 就 应 
该 有 点 熟悉 了 。 


回忆 一 下 ， 我 们 曾经 在 3.4.1 小 节 为 了 使 用 一 个 自 定义 的 标题 栏 ， 而 把 系 
统 原生 的 ActionBar 隐 藏 掉 。 没 错 ， 每 个 活动 最 顶部 的 那个 标题 栏 其 实 束 
是 ActionBar， 之 前 我 们 编写 的 所 有 程序 里 一 直 都 有 ActionBar 的 里 影 。 


不 过 ActionBar 由 于 其 设计 的 原因 ， 被 限定 只 能 位 于 活动 的 顶部， 从 而 不 
能 实现 一 些 Material 。” Design 的 效果 ， 因 此 官方 现在 已 经 不 再 建议 使 用 
ActionBar 了 。 那 么 本 书 中 我 也 就 不 准备 再 介绍 ActionBar 的 用 法 了 ， 而 
是 直接 讲解 现在 更 加 推荐 使 用 的 Toolbar。 


Toolbar 的 强大 之 处 在 于 ， 它 不 仅 继 承 了 ActionBar 的 所 有 功能 ， 而 且 灵 
活性 很 高 ， 可 以 配合 其 他 控件 来 完成 一 些 Material Design 的 效果 ， 下 面 
我 们 就 来 具体 学 习 一 下 。 


首先 你 要 知道 ， 任 何 一 个 新 建 的 项 目 ， 默 认 都 是 会 显示 ActionBar 的 ， 这 
个 想必 你 已 经 见识 过 太 多 次 了 。 那 么 这 个 ActionBar 到 底 是 从 哪里 来 的 
呢 ? 其 实 这 是 根据 项 目 中 指定 的 主题 来 显示 的 ， 打 开 
AndroidManifest.xml 文 件 看 一 下 ， 如 下 所 示 : 























supportsRtl="true 
id:theme="@style/AppTheme"> 


可 以 看 到 ， 这 里 使 用 android:theme 属 性 指定 了 一 个 AppTheme 的 主题 。 
那么 这 个 AppTheme 又 是 在 哪里 定义 的 呢 ? 打开 res/values/styles.xml 文 
件 ， 代 码 如 下 所 示 : 


<resources> 


<item name="colorPrimaryDark">@color/colorPrimaryDark</item> 
<item name="colorAccent">@color/colorAccent</item> 
</style> 


</resources> 


这 里 定义 了 一 个 叫 AppTheme 的 主题 ， 然 后 指定 它 的 parent 主 题 是 
Theme.AppCompat.Light.DarkActionBar。 这 个 DarkActionBar 是 一 个 深 色 
的 ActionBar 主 题 ， 我 们 之 前 所 有 的 项 目 中 自 带 的 ActionBar 就 是 因为 指 
定 了 这 个 主题 才 出 现 的 。 


而 现在 我 们 准备 使 用 Toolbar 来 蔡 代 ActionBar， 因 此 需要 指定 一 个 不 带 
ActionBar 的 主题 ， 通 常 nae 和 
Theme.AppCompat.Light.NoActionBar 这 两 种 主题 可 选 。 其 中 
Theme.AppCompat.NoActionBar 表 示 深 色 主 题 ， 它 会 将 界面 的 主体 上 颜色 
设 成 深 色 ， 陪 衬 颜色 设 成 淡色 。 而 Theme.AppCompat.Light,.NoActionBar 
表示 淡色 主题 ， 它 会 将 界面 的 主体 颜色 设 成 淡色 ， 陪 衬 颜 色 设 成 深 色 。 
具体 的 效果 你 可 以 自己 动手 试 一 试 ， 这 里 由 于 我 们 之 前 的 程序 一 直 都 是 
以 淡色 为 主 的 ， 那 么 我 就 选用 淡色 主题 了 ， 如 下 所 示 : 


<resources> 








<!-- Base application theme. --> 
<style name="AppTheme" parent="Theme. Pheonpas> Light.NoActionBar" 
<!-- Customize your theme here. - 
<item name="colorPrimary" Oe ole colorrinarve </item> 
<item name="colorPrimaryDark">@color/colorPrimaryDark</item> 
<item name="colorAccent">@color/colorAccent</item> 
</style> 


</resources> 


然后 观察 一 下 AppTheme 中 的 属性 重 写 ， 这 里 重 写 了 

Lr colorPrimaryDark 利 colorAccent 这 3 个 属 1 a 
这 3 个 属性 分 别 代表 着 什么 位 置 的 颜色 呢 ? 我 用 语言 比较 难 描述 

还 是 通过 一 张 图 来 理解 一 下 吧 ， 如 图 12.2 所 示 。 
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图 12.2 各 属性 指定 颜色 的 位 置 


可 以 看 到 ， 每 个 属性 所 指定 颜色 的 位 置 直接 一 目 了 然 了 。 
除了 上 述 3 个 属性 之 外 ， 我 们 还 可 以 通过 





textColorPrimary、 windowBackg round 和 | navigationBarcolor 等 属性 来 控 


制 更 多 位 置 的 颜色 。 不 过 唯 独 colorAccent 这 个 属性 比较 难 理解 ， 它 不 


只 是 用 来 指定 这 样 一 个 按钮 的 颜色 ， 而 是 更 多 表达 了 一 个 强调 的 意思 ， 
比如 一 些 控件 的 选中 状态 也 会 使 用 colorAccent 的 颜色 。 


现在 我 们 已 经 将 ActionBar 隐 藏 起 来 了 了， 那么 接 下 来 看 一 看 如 何 使 用 
Toolbar 来 蔡 代 ActionBar。 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


ameLayout xmlns:android="http://schemas.an 
了 


roid.com/apk/res/android" 
ns:app="http://schemas.android.com/apk/res-auto" 
i out_wi 


<android.support . 
android:id=" 


v7 .widget.Toolbar 
:id="@+id/toolbar" 


d 
id:layout._\ 
id:layout_hei 

id ckground="?attr/colorPrimary" 
d S| 

p h 


y 
i me="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
U eme="@style/ThemeOverlay.AppCompat .Light" /> 


虽然 这 段 代码 不 长 ， 但 是 里 面 着 实 有 不 少 技术 点 是 需要 我 们 去 仔细 琢 靡 
一 下 的 。 首 先 看 一 下 第 2 行 ， 这 里 使 用 xmlns:app 指 定 了 一 个 新 的 命名 空 
间 。 思 考 一 下 ， 正 是 由 于 每 个 布局 文件 都 会 使 用 xmlns:android 来 指定 
一 个 命名 空间 ， 因 此 我 们 才能 一 直 使 用 android:id、android: 
layout_width 等 写法 ， 那么 这 里 指定 了 xmlns:app， 也 就 是 说 现在 可 以 使 
用 app:attribute 这 样 的 写法 了 。 但 是 为 什么 这 里 要 指定 一 个 xmlns:app 
的 命名 空间 呢 ? 这 是 由 于 Material Design 是 在 Android 5.0 系 统 中 才 出 现 
的 ， 而 很 多 的 Material 属 性 在 5.0 之 前 的 系统 中 并 不 存在 ， 那 么 为 了 能 够 
兼容 之 前 的 老 系 统 ， 我 们 融 不 能 使 用 android:attribute 这 样 的 写法 了 ， 
而 是 应 该 使 用 app:attribute。 


接 下 来 定义 了 一 个 Toolbar 控 件 ， 这 个 控件 是 由 appcompat-v7 库 提供 的 。 
这 里 我 们 给 Toolbar 指 定 了 一 个 id， 将 它 的 宽度 设置 为 mnatch_parent， 高 
度 设置 为 actionBar 的 高 度 ， 背 景色 设置 为 colorPrimary。 不 过 下 面 的 部 分 
就 稍微 有 点 难 理解 了 ， 由 于 我 们 刚才 在 styles.xml 中 将 程序 的 主题 指定 成 
了 淡色 主题 ， 因 此 Toolbar 现 在 也 是 淡色 主题 ， 而 Toolbar 上 面 的 各 种 元 
素 就 会 自动 使 用 深 色 系 ， 这 是 为 了 和 主体 颜色 区 别 开 。 但 是 这 个 效果 看 
起 来 就 会 很 差 ， 之 前 使 用 ActionBar 时 文字 都 是 白色 的 ， 现 在 变 成 黑色 的 
会 很 难看 。 那 么 为 了 能 让 Toolbar 单 独 使 用 深 色 主题 ， 这 里 我 们 使 

用 android:theme 属 性 ， 将 Toolbar 的 主题 指定 成 了 
ThemeOverlay.AppCompat.Dark.ActionBar。 但 是 这 样 指 定 完 了 之 后 义 会 
出 现 新 的 问题 ， 如 果 Toolbar 中 有 沫 单 按钮 〈 我 们 在 2.2.5 小 节 中 学 过 ) ， 
那么 弹出 的 菜单 项 也 会 变 成 深 色 主题 ， 这 样 就 再 次 变 得 十 分 难看 ， 于 是 
这 里 使 用 了 app:popupTheme 属 性 单独 将 弹出 的 菜单 项 指定 成 了 淡色 主 
题 。 之 所 以 使 用 app:popupTheme， 是 因为 popupTheme 这 个 属性 是 在 
Android 5.0 系 统 中 新 增 的 ， 我 们 使 用 app:popupTheme 的 话 就 可 以 兼容 
Android 5.0 以 下 的 系统 了 。 


如 果 你 觉得 上 面 的 描述 很 绕 的 话 ， 可 以 自己 动手 做 一 做 试验 ， 看 看 不 指 
定 上 述 主题 会 是 什么 样 的 效果 ， 这 样 你 会 理解 得 更 加 深刻 。 




















写 完 了 布局 ， 接 下 来 我 们 修改 MainActivity， 代 码 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


@override 

protected void onCreate(Bundle savedInstanceState) 下 
Super.oncCreate(SavedInstanceState) 
SetContentView(R.1Layout.activity | main); 
Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar); 
setSupportActionBar (toolbar); 


这 里 关键 的 代码 只 有 两 句 ， 首 先 通 过 findviewById() 得 到 Toolbar 的 实 
例 ， 然后 调用 setsupportActionBar() 方 法 并 将 Toolbar 的 实例 传 入 ， 这 
样 我 们 就 做 到 既 使 用 了 Toolbar， 又 让 它 的 外 观 与 功能 都 和 ActionBar 一 


致 了 。 
现在 运行 一 下 程序 ， 效 果 如 图 12.3 所 示 。 
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图 12.3 Toolbar 的 标准 界面 


这 个 标题 栏 我 们 再 熟悉 不 过 了 ， 虽 然 看 上 去 和 之 前 的 标题 栏 没 什么 两 
样 ， 但 其 实 它 已 经 是 Toolbar 而 不 是 ActionBar 了 。 因 此 它 现 在 也 具备 了 
实现 Material Design 效 果 的 能 力 ， 这 个 我 们 在 后 面 就 会 学 到 。 


接 下 来 我 们 再 学 习 一 些 Toolbar 比 较 党 用 的 功能 吧 ， 比 如 修改 标题 栏 上 显 
示 的 文字 内 容 。 这 上段 文字 内 容 是 在 AndroidManifest.xml 中 指定 的 ， 如 下 
所 示 : 


<application 

android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<activity 

android:name=" .MainActivity" 

android:label="Fruits"> 





</activity> 


</application> 


这 里 给 activity 增 加 了 一 个 android:1label 属 性 ， 用 于 指定 在 Toolbar 中 
显示 的 文字 内 容 ， 如 果 没 有 指定 的 话 ， 会 默认 使 用 application 中 指定 
的 label 内 容 ， 也 束 是 我 们 的 应 用 名 称 。 


不 过 只 有 一 个 标题 的 Toolbar 看 起 来 太 单调 了 ， 我 们 还 可 以 再 添加 一 些 
action 按 铀 来 让 Toolbar 更 加 丰富 一 些 ， 这 里 我 提前 准备 了 几 张 图 片 来 作 
为 按钮 的 图 标 ， 将 它们 放 在 了 drawable-xxhdpi 目 录 下 。 现 在 右 击 res 目 录 
New Directory， 创 建 一 个 menu 文 件 夹 。 然 后 右 击 menu 文 件 夹 
一 New 一 Menu resource file， 创建 一 个 toolbar.xml 文 件 ， 并 编写 如 下 代 
码 : 
<menu xmlns: android= "http://schemas.android. com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
es :id="@+id/backup" 
android:icon="@drawable/ic_backup" 
android:title="Backup" 
app:showAsAction="always" /> 
A on ete 
android:icon="@drawable/ic_delete" 
android:title="Delete" 
app:showAsAction="ifRoom" /> 
0 01 de 
android:icon="@drawable/ic_settings" 
android:title="Settings" 


app:showAsAction="never" /> 
</menu> 


可 以 看 到 ， 我 们 通过 <item> 标 签 来 定义 action 按 钮 ，android:id 用 于 指 
定 按 钮 的 id，android:icon 用 于 指定 按钮 的 图 标 ，android:title 用 于 指 
定 按钮 的 文字 。 


接着 使 用 app:showAsAction 来 指定 按钮 的 显示 位 置 ， 之 所 以 这 里 再 次 使 
用 了 app 命 名 空间 ， 同 样 是 为 了 能 够 兼容 低 版 本 的 系统 。showAsAction 主 
要 有 以 下 几 种 值 可 选 : always 表 示 永 远 显 示 在 Toolbar 中 ， 如 果 屏 幕 空间 
不 够 则 不 显示 ; ifRoom 表 示 屏 幕 空间 足够 的 情况 下 显示 在 Toolbar 中 ， 

不 够 的 话 就 显示 在 菜单 当中 ; never 则 表示 永远 显示 在 菜单 当中 。 注 

意 ，Toolbar 中 的 action 按 钮 只 会 显示 图 标 ， 染 单 中 的 action 按 钮 只 会 显示 
文字 。 


接 下 来 的 做 法 就 和 2.2.5 小 市 中 的 完全 一 臻 了 ， 修 改 MainActivity 中 的 代 
码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


























public boolean onCreateOptionsMenu(Menu menu) { 
getMenuInflater().inflate(R.menu.toolbar, menu); 
return true; 


} 


@Override 
public boolean onOptionsItemSelected(MenuItem item) { 
Switch (item.getItemId()) { 
case R.id.backup: 
Toast.makeText(this, "You clicked Backup", Toast .LENGTH_SHORT). 
show(); 
break; 
case R-id delete: 
Toast.makeText(this, "You clicked Delete", Toast .LENGTH_SHORT). 


case R.id.settings : 
Toast.makeText(this, "You clicked Settings"，Toast .LENGTH_SHORT ) 





return true; 


非常 简单 ， 我 们 在 oncreateoptionsMenu() 方 法 中 加 载 了 toolbar.xml 这 个 
沫 单 文件 ， 然 后 在 onoptionsItemselected() 方 法 中 处 理 各 个 按钮 的 点 击 
事件 。 现 在 重新 运行 一 下 程序 ， 效 末 如 图 12.4 所 未 。 
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图 12.4 带 有 action 按 钮 的 Toolbar 


可 以 看 到 ，Toolbar 上 面 现在 显示 了 两 个 action 按 钮 ， 这 是 因为 Backup 按 
钮 指定 的 显示 位 置 是 always，Delete 按 钮 指定 的 显示 位 置 是 ifRoom， 而 
现在 屏幕 空间 很 充足 ， 因 此 两 个 按钮 都 会 显示 在 Toolbar 中 。 另 外 一 个 
Settings 按 钮 由 于 指定 的 显示 位 置 是 never， 所 以 不 会 显示 在 Toolbar 中 ， 
点 击 一 下 最 右边 的 沫 单 按钮 来 展开 瑟 蛙 项 ， 你 就 能 找到 Settings 按 包 
. 另外 这 些 action 按 钮 都 是 可 以 啊 应 点 击 事件 的 ， 你 可 以 自己 去 试 一 
1 


好 了 ， 关 于 Toolbar 的 内 容 束 先 讲 这 么 多 吧 。 当 然 Toolbar 的 功能 还 远 远 
不 只 这 些 ， 不 过 我 们 显然 无 法 在 一 节 当 中 就 把 所 有 的 用 法 全 部 学 完 ， 后 
面 会 结合 其 他 控件 来 挖掘 Toolbar 的 更 多 功能 。 























12.3 ”滑动 菜单 


滑动 菜单 可 以 说 是 Material Design 中 最 常见 的 效果 之 一 了 ， 在 许多 著名 
的 应 用 〈 如 Gmail、Google+ 等 ) 中 ， 都 有 清 动 菜单 的 功能 。 虽 说 这 个 功 
能 看 上 去 好 像 挺 复杂 的 ， 不 过 借助 谷歌 提供 的 各 种 工具 ， 我 们 可 以 很 轻 
松 地 实现 非常 炫 酷 的 清 动 菜单 效果 ， 那 么 我 们 马上 开始 吧 。 


12.3.1 DrawerLayout 


所 谓 的 滑动 菜单 就 是 将 一 些 逐 单 选 项 隐藏 起 来 ， 而 不 是 放置 在 主屏 攻 
上 ， 然 后 可 以 通过 滑动 的 方式 将 沫 单 显示 出 来 。 这 种 方式 既 节 省 了 屏 帮 
空间 ， 又 实现 了 非常 好 的 动画 效果 ， 是 Material Design 中 推荐 的 做 法 。 


不 过 如 果 我 们 全 徘 目 己 去 实现 上 述 功 能 的 话 ， 难 度 忍 怕 就 很 大 了 。 邓 运 
的 是 ， 谷 歌 提 供 了 一 个 DrawerLayout 控 件 ， 借 助 这 个 控件 ， 实 现 滑 动 菜 
单 简单 又 方便 。 


先 来 简单 介绍 一 下 DrawerLayout 的 用 法 吧 。 首 先 它 是 一 个 布局 ， 在 布局 
中 允许 放 入 两 个 直接 子 控件 ， 第 一 个 子 控件 是 主屏 硕 中 显示 的 内 容 ， 第 
二 个 子 控件 是 滑动 亲 单 中 显示 的 内 容 。 因 此 ， 我 们 就 可 以 对 
activity_main.xml 中 的 代码 做 如 下 修改 : 


<android.support.v4.widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawer_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 





























<FrameLayout 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android.support.v7.widget.Toolbar 
android:id="@+id/toolbar" 
android:layout_width="match_parent" 
android:layout_height="?attr/actionBarSize" 
android:background="?attr/colorPrimary" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:popupTheme="@style/ThemeOverlay.AppCompat .Light" /> 


</FrameLayout> 


<TextView 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:layout_gravity="start" 
android:text="This is menu" 
android:textSize="30sp" 
android:background="#FFF" /> 





</android.support.v4.widget.DrawerLayout> 





可 以 看 到 ， 这 里 最 外 层 的 控件 使 用 了 DrawerLayout， 这 个 控件 是 由 
support-v4 库 提供 的 。DrawerLayout 中 放置 了 两 个 直接 子 控件 ， 第 一 个 子 
控件 是 FrameLayout， 用 于 作为 主屏 幕 中 显示 的 内 容 ， 当 然 里 面 还 有 我 
们 刚刚 定义 的 Toolbar。 第 二 个 子 控件 这 里 使 用 了 一 个 TextView， 用 于 作 
为 滑动 表单 中 显示 的 内 容 ， 其 实 使 用 什么 都 可 以 ，DrawerLayout 并 没有 
限制 只 能 使 用 固定 的 控件 。 


但 是 关于 第 二 个 子 控件 有 一 点 需要 注意 ，layout_gravity 这 个 属性 是 必 
须 指 定 的 ， 因 为 我 们 需要 告诉 DrawerLayout 滑 动 菜 单 是 在 屏幕 的 左边 还 
是 右边 ， 指 定 left 表 示 滑 动 菜 单 在 左边 ， 指 定 right 表 示 滑 动 菜单 在 碳 
边 。 这 里 我 指定 了 start， 表 示 会 根据 系统 语言 进行 判断 ， 如 果 系 统 语言 
是 从 左 往 右 的 ， 比 如 英语 、 汉 语 ， 滑 动 菜 单 就 在 左边 ， 如 果 系 统 语言 是 
从 石 往 左 的 ， 比 如 阿拉 伯 语 ， 滑 动 业 捍 束 在 右边 。 


没 错 ， 只 需要 改动 这 么 多 就 可 以 了 ， 现 在 重新 运行 一 下 程序 ， 然 后 在 屏 
幕 的 左 侧 边缘 向 右 拖 动 ， 就 可 以 让 滑动 菜单 显示 出 来 了 ， 如 图 12.5 所 
示 。 
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图 12.5 “显示 滑动 菜单 界面 


然后 同志 滑动 沫 单 ， 或 者 点 击 一 下 沫 单 以 外 的 区 域 ， 都 可 以 让 滑动 菜单 
关闭 ， 从 而 回 到 主 界面 。 无 论 是 展示 还 是 隐藏 请 动 妆 单 ， 都 是 有 非常 流 
畅 的 动画 过 渡 的 。 


可 以 看 到 ， 我 们 只 是 稍微 改动 了 一 下 布局 文件 ， 瓯 能 实现 如 此 炫 酷 的 效 
果 ， 是 不 是 觉得 挺 激动 呢 ? ”不 过 现在 的 滑动 菜单 还 有 点 问题 ， 因 为 只 
有 在 屏幕 的 左 侧 边 缘 进行 拖 动 时 才能 将 沫 单 拖 出 来 ， 而 很 多 用 户 可 能 根 
本 就 不 知道 有 这 个 功能 ， 那 么 该 怎么 提示 他 们 呢 ? 


Material Design 建 议 的 做 法 是 在 Toolbar 的 最 左边 加 入 一 个 导航 按钮 ， 点 
击 了 按钮 也 会 将 滑动 菜单 的 内 容 展 示 出 来 。 这 样 就 相当 于 给 用 户 提供 了 
两 种 打开 滑动 菜单 的 方式 ， 防 止 一 些 用 户 不 知道 屏幕 的 左 侧 边缘 是 可 以 











拖 动 的 。 


下 面 我 们 开始 来 实现 这 个 功能 。 首 先 我 准备 了 一 张 导航 按钮 的 图 标 
ic_menu.png， 将 它 放 在 了 drawable-xxhdpi 目 录 下 。 然 后 修改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
private DrawerLayout mDrawerLayout; 
@Ooverride 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity_i main); 
Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar); 
setSupportActionBar (toolbar); 
mDrawerLayout = (DrawerLayout ) findViewById(R.id.drawer_layout); 
ActionBar actionBar = getSupportActionBar(); 
if (actionBar != null) { 
actionBar .setDisplayHomeAsUpEnabled(true) ， 
actionBar .setHomeAsUpIndicator(R.drawable.ic_menu) ; 
} 
} 


@Override 
public boolean onOptionsItemSelected(MenuItem item) { 
Switch (item.getItemId()) { 
case android.R.id.home: 
mDrawerLayout .openDrawer (GravityCompat .START); 
break; 


default: 


return true; 


这 里 我 们 并 没有 改动 多 少 代码 ， 前 先 调用 findviewById() 方 法 得 到 了 
| BA a i eo 
ActionBar 的 实例 ， 虽 然 这 个 ActionBar 的 有 具体 实现 是 由 Toolbar 来 完成 

的 。 ee ) 方 法 让 导航 按钮 
显示 出 来 ， 叉 调用 了 setHomeAsUpIndicator() 方 法 来 设置 一 个 导航 按钮 
图 标 。 实 际 上 ，Toolbar 最 左 侧 的 这 个 按钮 就 叫 作 HomeAsUp 按 钮 ， 它 默 
认 的 图 标 是 一 个 返回 的 箭头 ， 含 义 是 返回 上 一 个 活动 。 很 明显 ， 这 里 我 
们 将 它 默 认 的 样式 和 作用 都 进行 了 修改 。 


a On 击 事 件 
进行 处 理 ，HomeAsUp 按 钮 的 id 永 远 都 是 android.R.id.home。 然 后 调用 
DrawerLayout 的 openDrawer() 方 法 将 滑动 菜单 展示 出 来 ， 注 

意 openDrawer() 方 法 要 求 传 入 一 个 6ravity 参 数 ， 为 了 保证 这 里 的 行为 和 
XML 中 定义 的 一 致 ， 我 们 传 入 了 GravityCcompat .START。 


现在 重新 运行 一 下 程序 ， 效 果 如 图 12.6 所 示 。 
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图 12.6 显示 HomeAsUp 按 钮 


可 以 看 到 ， 在 Toolbar 的 最 左边 出 现 了 一 个 导航 按钮 ， 用 户 看 到 这 个 按钮 
就 知道 这 肯定 是 可 以 点 击 的 。 现 在 点 击 一 下 这 个 按钮 ， 滑 动 菜 单 界 面 就 
会 再 次 展示 出 来 了 。 


12.3.2 NavigationView 


目前 我 们 已 经 成 功 实现 了 滑动 菜单 功能 ， 其 中 滑动 功能 已 经 做 得 非常 好 
了 ， 但 是 荣 单 却 还 很 丑 ， 毕 竟 荣 单 页 面 仅仅 使 用 了 一 个 TextView， 非 常 
单调 。 有 对 比 才 会 有 落差 ， 我 们 看 一 下 Google+ 的 滑动 菜单 页 面 是 长 什 
么 样 的 ， 如 图 12.7 所 示 。 
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图 12.7 Google+ 的 滑动 菜单 页 面 


经 过 对 比 之 后 是 不 是 觉得 我 们 的 滑动 荣 单 页 面 更 妖 了 ? 不 过 没关系 ， 优 
化 请 动 菜 单 页 面 ， 这 了 就 是 我 们 本 小 节 的 全 部 目标 。 


事实 上 ， 你 可 以 在 滑动 菜单 页 面 定 制 任意 的 布局 ， 不 过 谷歌 给 我 们 提供 
了 一 种 更 好 的 方法 一 一 使 用 NavigationView。NavigationView 是 Design 
Support 库 中 提供 的 一 个 控件 ， 它 不 仅 是 严格 按照 Material Design 的 要 求 
来 进行 设计 的 ， 而 且 还 可 以 将 滑动 亲 单 页 面 的 实现 变 得 非常 简单 。 接 下 
来 我 们 就 学 习 一 下 NavigationView 的 用 法 。 


首先 ， 既 然 这 个 控件 是 Design ”Support 库 中 提供 的 ， 那 么 我 们 就 需要 将 



































这 个 库 引 入 到 项 目 中 才 行 。 打 开 app/build.gradle 文 件 ， 在 dependencies 闭 
包 中 添加 如 下 内 容 : 


dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 
compile 'com.android.support:appcompat-v7:24.2.1" 
testCompile 'junit:junit:4.12' 
compile 'com.android.support:design:24.2.1" 
compile 'de.hdodenhof :circleimageview:2.1.0' 


这 里 添加 了 两 行 依赖 关系 ， 第 一 行 就 是 Design Support 库 ， 第 二 行 是 一 
个 开源 项 目 CircleImageView， 它 可 以 用 来 轻松 实现 图 片 贺 形 化 的 功能 ， 
我 们 待 会 束 会 用 到 它 。CircleImageView 的 项 目 主 页 地 址 


三 | 


十: https://github.com/hdodenhof/CirclelmageView。 


在 开始 使 用 NavigationView 之 前 ， 我 们 还 需要 提前 准备 好 两 个 东西 : 
menu 和 和 headerLayout。menu 是 用 来 在 NavigationView 中 显示 具体 的 表单 
项 的 ，headerLayout 则 是 用 来 在 NavigationView 中 显示 头 部 布局 的 。 


我 们 先 来 准备 menu， 这 里 我 事先 找 了 几 张 图 片 来 作为 按钮 的 图 标 ， 并 
将 它们 放 在 了 drawable-xxhdpi 目 录 下 。 然 后 右 击 menu 文 件 夹 

-New Menu resource 人 fle， 创建 一 个 nav_menu.xml 文 件 ， 并 编写 如 下 
代码 : 


<menu xmlns:android="http://schemas.android.com/apk/res/android"> 
<group android:checkableBehavior="single"> 

<item 
android:id="@+id/nav_call" 
android:icon="@drawable/nav_call" 
android:title="Call" /> 

<item 
android:id="@+id/nav_friends" 
android:icon="@drawable/nav_friends" 
android:title="Friends" /> 

<item 
android:id="@+id/nav_location" 
android:icon="@drawable/nav_location" 
android:title="Location" /> 

<item 
android:id="@+id/nav_mail" 
android:icon="@drawable/nav_mail" 
android:title="Mail" /> 

<item 
android:id="@+id/nav_task" 
android:icon="@drawable/nav_task" 
android:title="Tasks" /> 

</group> 
</menu> 


我 们 首先 在 <menu> 中 内 套 了 一 个 <group> 标 签 ， 然 后 将 group 的 
checkableBehavior 属 性 指定 为 single。 group 表 示 一 个 
组 ，checkableBehavior 指 定 为 single 表 示 组 中 的 所 有 菜单 项 只 能 单 选 。 


那么 下 面 我 们 来 看 一 下 这 些 末 单项 吧 。 这 里 一 共 定 义 了 5 个 item， 分 别 
使 用 android:id 属 性 指定 菜单 项 的 d，android:icon 属 性 指定 菜单 项 的 
图 标 ，android:title 属 性 指定 菜单 项 显示 的 文字 。 束 是 这 么 简单 ， 现 
在 我 们 已 经 把 menu 准 备 好 了 。 


接 下 来 应 该 准备 headerLayout 了 了， 这 是 一 个 可 以 随意 定制 的 布局 ， 不 过 
我 并 不 想 将 它 做 得 太 复杂 。 这 里 简单 起 见 ， 我 们 就 在 headerLayout 中 放 
置 头 像 、 用 户 名 、 邮 箱 地 址 这 3 项 内 容 吧 。 


说 到 头像 ， 那 我 们 还 需要 再 准备 一 张 图 片 ， 这 里 我 找 了 一 张 宠 物 图 片 ， 

并 把 它 放 在 了 drawable-xxhdpi 目 录 下 。 男 外 这 张 图 片 最 好 是 一 张 正 方形 
图 乒 ， 因 为 待 会 我 们 会 把 它 圆 形 化 。 然 后 右 击 layout 文 件 夹 

一 New -Layout resource file， 创 建 一 个 nav_header.xml 文 件 。 修 改 其 中 
的 代码 ， 如 下 所 示 : 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent 
android:layout_height="180dp" 
android:padding="10dp" 
android:background="?attr/colorPrimary"> 











<de.hdodenhof .circleimageview.CircleImageView 
android:id="@+id/icon_image" 
android:layout_width="70dp" 
android:layout_height="70dp" 
android:src="@drawable/nav_icon" 
android:layout_centerInParent="true" /> 


<TextView 
android:id="@+id/mail" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_alignParentBottom="true" 
android:text="tonygreendev@gmail .com" 
android:textColor="#FFF" 
android:textSize="14sp" /> 








<TextView 
android:id="@+id/username" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_above="@id/mail" 
android:text="Tony Green" 
android:textColor="#FFF" 
android:textSize="14sp" /> 


</RelativeLayout> 


可 以 看 到 ， 布 局 文件 的 最 外 层 是 一 个 RelativeLayout， 我 们 将 它 的 宽度 设 
为 match_parent， 高 度 设 为 180dp， 这 是 一 个 NavigationView 比 较 适 合 的 
高 度 ， 然 后 指定 它 的 背景 色 为 colorPrimary。 


在 RelativeLayout 中 我 们 放置 了 3 个 控件 ，CircleImageView 是 一 个 用 于 将 
图 片 圆 形 化 的 控件 ， 它 的 用 法 非常 简单 ， 基 本 和 ImageView 是 完全 一 样 
的 ， 这 里 给 它 指 定 了 一 张 图 片 作 为 头像 ， 然 后 设置 为 居中 显示 。 男 外 两 
个 TextView 分 别 用 于 显示 用 户 名 和 邮箱 地 址 ， 它 们 都 用 到 了 一 些 








RelativeLayout 的 定位 属性 ， 相 信和 肯定 难 不 倒 你 吧 ? 


现在 menu 和 headerLayout 都 准备 好 了 ， 我 们 终于 可 以 使 用 
NavigationView 了 。 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<android.support.v4.widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawer_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<FrameLayout 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android.support.v7.widget.Toolbar 
android:id="@+id/toolbar" 
android:layout_width="match_parent" 
android:layout_height="?attr/actionBarSize" 
android:background="?attr/colorPrimary" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:popupTheme="@style/ThemeOverlay.AppCompat .Light" /> 


</FrameLayout> 


<android.support.design.widget.NavigationView 
android:id="@+id/nav_view" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:layout_gravity="start" 
app:menu="@menu/nav_menu" 
app:headerLayout="@layout/nav_header "/> 


</android.support.v4.widget.DrawerLayout> 


可 以 看 到 ， 我 们 将 之 前 的 TextView 换 成 了 NavigationView， 这 样 滑动 菜 
单 中 显示 的 内 容 也 就 变 成 NavigationView 了 。 这 里 又 通过 app:menu 和 
app:headerLayout 属 性 将 我 们 刚才 准备 好 的 menu 和 headerLayout 设 置 了 


进去 ， 这 样 NavigationView 就 定义 完成 了 。 





NavigationView 虽 然 定 义 完 成 了 ， 但 是 我 们 还 要 去 处 理 荣 单项 的 点 击 事 


件 才 行 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
private DrawerLayout mDrawerLayout; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceSstate); 
setContentView(R.1layout.activity main); 
Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar); 
setSupportActionBar (toolbar); 
mDrawerLayout = (DrawerLayout) findViewById(R.id.drawer_layout); 
NavigationView navView = (NavigationView) findViewById(R.id.nav_view); 
ActionBar actionBar = getSupportActionBar(); 
if (actionBar != null) { 
actionBar.setDisplayHomeAsUpEnabled(true); 
actionBar.setHomeAsUpIndicator(R.drawable.ic_menu); 


navView.setCheckedItem(R.id.nav_call); 
navView,.setNavigationItemSelectedListener(new NavigationView.OnNavigation 
ItemSelectedListener() { 
@override 
public boolean onNavigationItemSelected(MenuItem item) { 
mDrawerLayout.closeDrawers(); 
return true; 


}); 


代码 还 是 比较 简单 的 ， 这 里 首先 获取 到 了 NavigationView 的 实例 ， 然 后 
调用 它 的 setcheckedItem( ) 方 法 将 Call 朋 单项 设置 为 默认 选中 。 接 着 调 
用 了 setNavigationItemsSelectedListener() 方 法 来 设置 一 个 菜单 项 选中 
事件 的 监听 器 ， 当 用 户 点 击 了 任意 全 单项 时 ， 束 会 回调 

到 onNavigationItemselected( ) 方 法 中 。 我 们 可 以 在 这 个 方法 中 写 相 应 
的 逻辑 处 理 ， 不 过 这 里 我 并 没有 附加 任何 逻辑 ， 只 是 调用 了 
DrawerLayout 的 closeDrawers() 方 法 将 滑动 亲 蛙 关闭 ， 这 也 是 合情合理 
的 做 法 。 


现在 可 以 重新 运行 一 下 程序 了 ， 点 击 一 下 Toolbar 左 侧 的 导航 按钮 ， 效 果 
如 图 12.8 所 示 。 
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图 12.8 ”NavigationView 界 面 


怎么 样 ? 这 样 的 冲 动 染 单 页 面 ， 你 无 论 如 何 也 不 能 说 它 恬 了 吧 ? 
Material Design 的 魅力 就 在 这 里 ， 它 真 的 是 一 种 非常 美观 的 设计 理念 ， 
人 的 各 种 规范 和 建议 来 设计 界面 ， 最 终 做 出 来 的 程序 就 是 特 
别 好 看 的 。 


相信 你 对 现在 做 出 来 的 效果 也 一 定 十 分 满意 吧 ? 不 过 不 要 满足 于 现状 ， 
后 面 我 们 会 实现 更 加 炫 酷 的 效果 。 跟 紧 脚 步 ， 继 续 学 习 。 


12.4 ” 旦 浮 按钮 和 可 交互 提示 


立 面 设计 是 Material Design 中 一 条 非常 重要 的 设计 思想 ， 也 就 是 说 ， 按 
照 Material Design 的 理念 ， 应 用 程序 的 界面 不 仅仅 只 是 一 个 平面 ， 而 应 
该 是 有 立体 效果 的 。 在 官方 给 出 的 示例 中 ， 最 简单 且 最 具 代 表 性 的 立 面 
设计 吏 是 悬浮 按钮 了 ， 这 种 按钮 不 属于 主 界面 平面 的 一 部 分 ， 而 是 位 于 
另外 一 个 维度 的 ， 因 此 束 会 给 人 一 种 悬浮 的 感觉。 


本 节 中 我 们 会 对 这 个 巧 浮 按钮 的 效果 进行 学 习 ， 夯 外 还 会 学 习 一 种 可 区 
互 式 的 提示 工具 。 关 于 提示 工具 ， 我 们 之 前 一 直 都 是 使 用 的 Toast， 但 
是 Toast 只 能 用 于 告知 用 户 人 菜 菜 事 情 已 经 发 生 了 ， 用 户 却 不 能 对 此 做 出 
任何 的 啊 应 ， 那 么 今天 我 们 就 将 在 这 一 方面 进行 扩展 。 














12.4.1 FloatingActionButton 


FloatingActionButton 是 Design Support 库 中 提供 的 一 个 控件 ， 这 个 控件 可 
以 帮助 我 们 比较 轻松 地 实现 悬浮 按钮 的 效果 。 其 实在 之 前 的 图 12.2 中 ， 
我 们 惑 已 经 预览 过 悬浮 按钮 是 长 什么 样子 的 了 ， 它 默认 会 使 用 
colorAccent 来 作为 按钮 的 颜色 ， 我 们 还 可 以 通过 给 按钮 指定 一 个 图 标 来 
表明 这 个 按钮 的 作用 是 什么 。 


下 面 开 始 来 具体 实现 。 首 先 仍然 需要 提前 准备 好 一 个 图 标 ， 这 里 我 放置 
了 一 张 ic_done.png 到 drawable-xxhdpi 目 录 下 。 然 后 修改 activity_main.xml 
中 的 代码 ， 如 下 所 示 : 


<android.support.v4.widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawer_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<FrameLayout 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android.support.v7.widget.Toolbar 
android:id="@+id/toolbar" 
android:layout_width="match_parent" 
android:layout_height="?attr/actionBarSize" 
android:background="?attr/colorPrimary" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:popupTheme="@style/ThemeOverlay.AppCompat .Light" /> 


<android.support.design.widget.FloatingActionButton 
android:id="@+id/fab" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="bottom|end" 
android:layout_margin="16dp" 
android:src="@drawable/ic_done" /> 





</FrameLayout> 


</android.support.v4.widget.DrawerLayout> 











可 以 看 到 ， 这 里 我 们 在 主屏 幕布 局 中 加 入 了 一 个 FloatingActionButton 。 

这 个 控件 的 用 法 并 没有 什么 特别 的 地 方 ，layout_width 和 layout_height 
属性 都 指定 成 wrap_content，1layout_gravity 属 性 指定 将 这 个 控件 放置 
于 屏幕 的 右 下 角 ， 其 中 end 的 工作 原理 和 之 前 的 start 是 一 样 的 ， 即 如 果 
系统 语言 是 从 左 往 右 的 ， 那 么 end 就 表示 在 右边 ， 如 果 系 统 语 言 是 从 石 

往 左 的 ， 那 么 end 就 表示 在 左边 。 然后 通过 layout_margin 属 性 给 控件 的 
四 周 留 点 边 距 ， 紧 贴 着 屏幕 边缘 肯定 是 不 好 看 的 ， 最 后 通过 src 属 性 给 

FloatingActionButton 设 置 了 一 个 图 标 。 
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错 ， 就 是 这 么 简单 ， 现 在 我 们 就 可 以 来 运行 一 下 了 ， 效 果 如 图 12.9 所 
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图 12.9 ”悬浮 按钮 的 效果 
亮 的 悬浮 按钮 就 在 屏幕 的 右 下 方 出现 了 。 


如 果 你 仔细 观察 的 话 ， 会 发 现 这 个 悬浮 按钮 的 下 面 还 有 一 点 阴影 。 其 
这 很 好 理解 ， 因 为 FloatingActionButton 是 悬浮 在 当 前 界面 上 的 识 然 是 
悬浮 ， 那 么 就 理 所 应 当 会 有 投影 ，Design “Support 库 连 这 种 细节 都 帮 有 我 
们 考虑 到 了 。 


说 到 悬浮 ， 其 实 我 们 还 可 以 指定 FloatingActionButton 的 悬浮 高 度 ， 如 下 
所 示 : 


<android.support.design.widget.FloatingActionButton 
android:id="@+id/fab 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="bottom|end" 











android:layout_margin="16dp" 
android:src="@drawable/ic_done" 
app:elevation="8dp" /> 


这 里 使 用 app: elevation 属 性 来 给 FloatingActionButton 指 定 一 个 高 度 值 ， 
高 度 值 越 大 ， 投 影 苑 围 也 越 大 ， 但 是 投影 效果 越 淡 ， 高 度 值 越 小 ， 投 影 
范围 也 越 小 ， 但 是 投影 效果 越 浓 。 当 然 这 些 效果 的 差异 其 实 都 不 怎么 明 
显 ， 我 个 人 感觉 使 用 默认 的 FloatingActionButton 效 果 就 已 经 足够 了 。 


接 下 来 我 们 看 一 下 FloatingActionButton 是 如 何 处 理 点 击 事件 的 ， 毕 竟 ， 
一 个 按钮 首先 要 能 点 击 才 有 意义 。 修 改 MainActivity 中 的 代码 ， 如 下 所 
小 : 


public class MainActivity extends AppCompatActivity { 
private DrawerLayout mDrawerLayout; 


@override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceSstate); 
setContentView(R.1layout.activity_ main); 


FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab); 
fab.setonClickListener(new View.OnClickListener() { 

@override 

public void onClick(View v 

Toast.makeText (MainActivity.this, "FAB clicked", Toast.LENGTH_ 
SHORT) .show(); 

} 

}); 


如 果 你 在 期 等 FloatingActionButton 会 有 什么 特殊 用 法 的 话 ， 那 可 能 就 要 
让 你 失望 了 ， 它 和 普通 的 Button 其 实 没什么 两 样 ， 都 是 调 

用 setonclickListener() 方 法 来 注册 一 个 监听 器 ， 当 点 击 按钮 时 ， 就 会 
执行 监听 器 中 的 onclick() 方 法 ， 这 里 我 们 在 onclick() 方 法 中 弹出 了 一 


个 Toast。 








现在 重新 运行 一 下 程序 ， 并 点 击 FloatingActionButton， 效 果 如 图 12.10 所 
人 外 o 
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图 12.10 “处理 FloatingActionButton 的 点 击 事件 
12.4.2 Snackbar 


现在 我 们 已 经 掌握 了 FloatingActionButton 的 基本 用 法 ， 不 过 在 上 一 小 节 
处 理 点 击 事件 的 时 候 ， 仍 然 是 使 用 Toast 来 作为 提示 工具 的 ， 本 小 节 中 
我 们 就 来 学 习 一 个 Design Support 库 提供 的 更 加 先进 的 提示 工具 一 一 


Snackbar。 


首先 要 明确 ，Snackbar 并 不 是 Toast 的 替代 品 ， 它 们 两 者 之 间 有 着 不 同 的 
应 用 场景 。Toast 的 作用 是 告诉 用 户 现在 发 生 了 什么 事情 ， 但 同时 用 户 
只 能 被 动 接收 这 个 事情 ， 因 为 没有 什么 办 法 能 让 用 户 进 行 选择 。 而 
Snackbar 则 在 这 方面 进行 了 扩展 ， 它 允许 在 提示 当中 加 入 一 个 可 交互 按 





钮 ， 当 用 户 点 击 按钮 的 时 候 可 以 执行 一 些 人 额外 的 迎 辑 操作 。 打 个 比方 ， 
如 果 我 们 在 执行 删除 操作 的 时 候 只 弹出 一 个 Toast 提 示 ， 那 么 用 户 要 是 
误 删 了 茶 个 重要 数据 的 话 肯 定 会 十 分 抓 狂 吧 ， 但 是 如 果 我 们 增加 一 个 
Undo 按 钮 ， 束 相 当 于 给 用 户 提供 了 一 种 弥补 措施 ， 从 而 大 大 降低 了 事 
故 发 生 的 概率 ， 提 升 了 用 尸体 验 。 


Snackbar 的 用 法 也 非常 简单 ， 它 和 Toast 是 基本 相似 的 ， 只 不 过 可 以 额外 
增加 一 个 按钮 的 点 击 事件 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 





private DrawerLayout mDrawerLayout; 


@override 

pr rote ct gy Ridin nCreate(Bundle savedInstanceState) { 
upe 人 ate Elsa vedIn a nc esta te) 

Eeon 这 FeV iew(R. a ayout.activity_main); 


cat ingActionButton_fab = (FloatingActionButton) findviewByTd(R,id.fab); 
Tab setOncli 让 et (how View: OnClICkKELStenery T 
Boverride 


pu ubliC void onClick(View view) { 
Snackbar .make(view, "Da ta deleted", Snackbar. ENG _SHORT) 
.SetAction("Undo"，new 0 iew. Onc. C1i ckLis er() 区 
Me 
public void onClick(View 3 
et makeText (MainActivity.thi "Data restored" 
Toast .LENGTH HOT) Sion 


可 以 看 到 ， 这 里 调用 了 Snackbar 的 make() 方 法 来 创建 一 个 Snackbar 对 

象 ，make() 方 法 的 第 一 个 参数 需要 传 入 一 个 View， 只 要 是 当前 界面 布局 
的 任意 一 个 View 都 可 以 ，Snackbar 会 使 用 这 个 View 来 自动 查找 最 外 层 的 
布局 ， 用 于 展示 Snackbar。 第 二 个 参数 就 是 Snackbar 中 显示 的 内 容 ， 第 
三 个 参数 是 Snackbar 显 示 的 时 长 。 这 些 和 Toast 都 是 类 似 的 。 


接着 这 里 又 调用 了 一 个 setAction() 方 法 来 设置 一 个 动作 ， 从 而 让 
Snackbar 不 仅仅 是 一 个 提示 ， 而 是 可 以 和 用 户 进行 交互 的 。 简 单 起 见 ， 
我 们 在 动作 按钮 的 点 击 事件 里 面 弹出 一 个 Toast 提 示 。 最 后 调用 show( ) 方 
法 让 Snackbar 显 示 出 来 。 


现在 重新 运行 一 下 程序 ， 并 点 击 悬 译 按 钮 ， 效 果 如 图 12.11 所 示 。 

















一 





Data deleted 


< 





图 12.11 Snackbar 的 效果 


可 以 看 到 ，Snackbar 从 屏幕 底部 出 现 了 ， 上 面 有 我 们 所 设置 的 提示 文 
字 ， 还 有 一 个 Undo 按 钮 ， 按 钮 是 可 以 点 击 的 。 过 一 段 时 间 后 Snackbar 会 
自动 从 屏幕 底部 消失 。 


不 管 是 出 现 还 是 消失 ，Snackbar 都 是 带 有 动画 效果 的 ， 因 此 视觉 体验 也 
会 比较 好 。 


不 过 你 有 没有 发 现 一 个 bug， 这 个 Snackbar 竟 然 将 我 们 的 悬浮 按钮 给 遮 
挡住 了 。 虽 说 也 不 是 什么 重大 的 问题 ， 因 为 Snackbar 过 一 会 儿 束 会 自动 
消失 ， 但 这 种 用 户 体 验 总 归 是 不 友好 的 。 有 没有 什么 办 法 能 解决 一 下 

呢 ? 当然 有 ， 只 需要 借助 CoordinatorLayout 就 可 以 轻松 解决 。 





12.4.3 CoordinatorLayout 





CoordinatorLayout 可 以 说 是 一 个 加 强 版 的 FrameLayout， 这 个 布局 也 是 由 
Design ”Support 库 提供 的 。 它 在 普通 情况 下 的 作用 和 FrameLayout 基 本 一 
致 ， 不 过 既然 是 Design Support 库 中 提供 的 布局 ， 那 么 就 必然 有 一 些 
Material Design 的 魔力 了 。 


事实 上 ，CoordinatorLayout 可 以 监听 其 所 有 子 控件 的 各 种 事件 ， 然 后 目 
动 帮助 我 们 做 出 最 为 合理 的 啊 应 。 举 个 简单 的 例子 ， 刚 才 弹 出 的 
Snackbar 提 示 将 甚 浮 按钮 遮挡 住 了 ， 而 如 果 我 们 能 让 CoordinatorLayout 
监听 到 Snackbar 的 弹出 事件 ， 那 么 它 会 自动 将 内 部 的 
FloatingActionButton 问 上 俩 移 ， 从 而 确保 不 会 被 Snackbar 遮 挡 到 。 


至 于 CoordinatorLayout 的 使 用 也 非常 简单 ， 我 们 只 需要 将 原来 的 
FrameLayout 蔡 换 一 下 束 可 以 了 。 修 改 activity_main.xzml 中 的 代码 ， 如 下 
所 示 : 


<android.support.v4.widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawer_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android.support.design.widget.CoordinatorLayout 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android.support.v7.widget.Toolbar 
android:id="@+id/toolbar" 
android:layout_width="match_parent" 
android:layout_height="?attr/actionBarSize" 
android:background="?attr/colorPrimary" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:popupTheme="@style/ThemeOverlay.AppCompat .Light" /> 


<android.support.design.widget.FloatingActionButton 

android:id="@+id/fab" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="bottom|end" 
android:layout_margin="16dp" 
android:src="@drawable/ic_done" /> 

</android,.support.design.widget.CoordinatorLayout> 





</android.support.v4.widget.DrawerLayout> 


由 于 CoordinatorLayout 本 身 就 是 一 个 加 强 版 的 FrameLayout， 因 此 这 种 蔡 
换 不 会 有 任何 的 副作用 。 现 在 重新 运行 一 下 程序 ， 并 点 击 悬 浮 按钮 ， 效 
果 如 图 12.12 所 示 。 
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图 12.12” ”CoordinatorLayout 自 动 将 悬浮 按钮 上 移 





可 以 看 到 ， 巷 浮 按钮 自动 向 上 偏 移 了 Snackbar 的 同等 高 度 ， 从 而 确保 不 
会 被 追 挡住 ， 当 Snackbar 消 失 的 时 候 ， 巷 浮 按钮 会 自动 同 下 偏 移 回 到 原 
来 位 置 。 

男 外 悬浮 按钮 的 问 上 和 向 下 偏 移 也 是 伴随 着 动画 效果 的 ， 且 和 Snackbar 
完全 同步 ， 整 体 效果 看 上 去 特别 质心 悦目 。 


不 过 我 们 回 过 头 来 再 思考 一 下 ， 刚 才 说 的 是 CoordinatorLayout 可 以 监听 
其 所 有 子 控 件 的 各 种 事件 ， 但 是 Snackbar 好 像 并 不 是 CoordinatorLayonut 
的 子 控件 吧 ， 为 什么 它 却 可 以 被 监听 到 呢 ? 


其 实 道理 很 简单 ， 还 记得 我 们 在 Snackbar 的 make() 方 法 中 传 入 的 第 一 个 
参数 吗 ? 这 个 参数 就 是 用 来 指定 Snackbar 是 基于 哪个 View 来 触发 的 ， 刚 
才 我 们 传 入 的 是 FloatingActionButton 本 有 身 ， 而 FloatingActionButton 是 
CoordinatorLayout 中 的 子 控件 ， 因 此 这 个 事件 就 理 所 应 当 能 被 监 听 到 

了 。 你 可 以 目 己 再 做 个 试验 ， 如 果 给 Snackbar 的 make() 方 法 传 入 一 个 
DrawerLayout， 那 么 Snackbar 吏 会 再 次 遮挡 住 悬 浮 按钮 ， 因 为 
DrawerLayout 不 是 CoordinatorLayout 的 子 控件 ，CoordinatorLayout 也 就 无 
法 监听 到 Snackbar 的 弹出 和 隐藏 事件 了 。 


本 节 的 内 容 就 到 这 里 ， 接 下 来 我 们 继续 丰富 MaterialTest 项 目 ， 加 入 卡片 
式 布局 效果 。 





12.5 卡片 式 布局 


虽然 现在 MaterialTest 中 已 经 应 用 了 非常 多 的 Material Design 效果， 不 过 
你 会 发 现 ， 界 面 上 最 主要 的 一 块 区 域 还 处 于 空 日 状态 。 这 块 区 域 通常 都 
是 用 来 放置 应 用 的 主体 内 容 的 ， 我 准备 使 用 一 些 精 美的 水 果 图 片 来 填 元 


这 部 分 区 域 。 


那么 为 了 要 让 水 果 图 片 也 能 Material 化 ， 本 节 中 我 们 将 会 学 习 如 何 实现 
卡片 式 布局 的 效果 。 卡 片 式 布局 也 是 Materials Design 中 提出 的 一 个 新 的 
概念 ， 它 可 以 让 页 面 中 的 元 素 看 起 来 束 像 在 卡片 中 一 样 ， 并 且 还 能 拥有 
册 角 和 投影 ， 下 面 我 们 就 开始 具体 学 习 一 下 。 


12.5.1 CardView 

CardView 是 用 于 实现 卡片 式 布局 效果 的 重要 控件 ， 由 appcompat-v7 库 提 
供 。 实 际 上 ，CardView 也 是 一 个 FrameLayout， 只 是 额外 提供 了 圆 角 和 
阴影 等 效果 ， 看 上 去 会 有 立体 的 感觉 。 

我 们 先 来 看 一 下 CardView 的 基本 用 法 吧 ， 其 实 非常 简单 ， 如 下 所 示 : 














这 里 定义 了 一 个 CardView 布 局 ， 我 们 可 以 通过 app:cardcornerRadius 属 
性 指定 卡 毛 圆 角 的 跌 度 ， 数 值 越 大 ， 圆 角 的 骂 度 也 越 大 。 另 外 还 可 以 通 
过 app:elevation 属 性 指定 卡片 的 高 度 ， 高 度 值 越 大 ， 投 影 范 围 也 越 
大 ， 但 是 投影 效果 越 淡 ， 高 度 值 越 小 ， 投 影 范围 也 越 小 ， 但 是 投影 效果 
越 浓 ， 这 一 点 和 FloatingActionButton 是 一 致 的 。 


然后 我 们 在 CardView 布 局 中 放置 了 一 个 TextView， 那 么 这 个 TextView 就 
会 显示 在 一 张 卡 片 当中 了 ，CardView 的 用 法 就 是 这 么 简单 。 








但 是 我 们 显然 不 可 能 在 如 此 宽阔 的 一 块 空白 区 域内 只 放 置 一 张 卡片， 为 
了 能 够 充分 利用 屏幕 的 空间 ， 这 里 我 准备 综合 运用 一 下 第 i 到 的 
知识 ， 使 用 RecyclerView 来 填充 MaterialTest 项 目的 主 界 面部 分 。 还 记得 
之 前 实现 过 的 水 果 列 表 效 果 吗 ?这 次 我 们 将 升级 一 下 ， 实现 一 个 高 配 版 
的 水 有 果 列 表 效 果 。 


既然 是 要 实现 水 条 列表 ， 那 么 首先 肯定 需要 准备 许多 张 水 果 图 片 ， 
我 从 网 上 挑选 了 一 些 精美 的 水 果 图 片 ， 将 它们 复制 到 了 项 目 当中 


然后 由 于 我 们 还 需要 用 到 RecyclerView、CardView 这 几 个 控件 ， 因 此 必 
须 在 app/build.gradle 文 件 中 声明 这 些 库 的 依赖 才 行 : 


dependencies { 
compile fileTree(dir: ‘Libs'; include: T"*jar’]} 
compile 'com.android.support:appcompat-v7:24.2.1" 
testCompile 'junit:junit:4.12' 
compile 'com.android.support:design:24.2.1" 
compile 'de.hdodenhof :circleimageview:2.1.09' 
compile 'com.android.support:recyclerview-v7: 2 2 
compile 'com.android.support:cardview-v7:24.2. 
compile 'com.github.bumptech.glide:glide:3.7. a 


注意 上 述 声 明 的 最 后 一 行 ， 这 里 添加 了 一 个 Glide 库 的 依赖 。Glide 是 一 
个 超级 强大 的 图 片 加 载 库 ， 它 不 仅 可 以 用 于 加 载 本 地 图 片 ， 还 可 以 加 载 
网 络 图 片 、GIF 图 片 、 甚 至 是 本 地 视频 。 最 重要 的 是 ，Glide 的 用 法 非常 
简单 ， 只 需 一 行 代 码 就 能 轻松 实现 复杂 的 图 片 加 载 功能 ， 因 此 这 里 我 们 
准备 用 它 来 加 载 水 果 图 片 。Glide 的 项 目 主页 地 址 


日 


十 : https://github.com/bumptech/glide。 


接 下 来 开始 具体 的 代码 实现 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 
修 \: 





<android.support.v4.widget.DrawerLayout 
mlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawer_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android.support.design.widget.CoordinatorLayout 
android:layout_width="match_parent 
android:layout_height="match_parent"> 


<android.support .v7.widget.Toolbar 
android:id="@+id/toolbar" 
android:layout width="match_parent" 
android:layout_height="?attr/actionBarSize" 
android:background="?attr/colorPrimary" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:popupTheme="@style/ThemeOverlay.AppCompat .Light" /> 


<android. support. v7 .widget. RecyclerView 
android:id= "@tid/recycler— View" 
android:layout_ width="match_parent" 
android:layout_height="match_parent" /> 


<android. support. aan widget， FloatingActionButton 
android:id="@+i 


android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="bottom|end" 
android:layout_margin="16dp" 
android:src="@drawable/ic_done" /> 
</android.support.design.widget.CoordinatorLayout> 


</android.support.v4.widget.DrawerLayout> 


这 里 我 们 在 CoordinatorLayout 中 添加 了 一 个 RecyclerView， 给 它 指定 一 
个 id， 然 后 将 宽度 和 高 度 都 设置 为 match_parent， 这 样 RecyclerView 也 就 
占 满 了 整个 布局 的 空间 。 


接着 定义 一 个 实体 类 Fruit， 代 人 码 如 下 所 示 : 


public class Fruit { 
private String name; 
private int imageId ; 


public Fruit(String name, int imageId) { 
this.name = name; 
this.imageId = imagelId; 


} 


public String getName() { 
return name; 


public int getImageId() { 
return imageId; 


Fruit 类 中 只 有 两 个 字段 ，name 表 示 水 果 的 名 字 ，imageId 表 示 水 果 对 应 
图 片 的 资源 id。 


然后 需要 为 RecyclerView 的 子 项 指定 一 个 我 们 自 定 义 的 布局 ， 在 layout 
目录 下 新 建 fruit_item.xml， 代 码 如 下 所 示 : 


<android.support.v7.widget.CardView 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:layout_margin="5dp" 
app:cardCcornerRadius="4dp"> 





<LinearLayout 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="wrap_content"> 


<ImageView 
android:id="@+id/fruit_image" 
android:layout_width="match_parent" 
android:layout_height="100dp" 
android:scaleType="centerCrop" /> 


<TextView 
android:id="@+id/fruit_name" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center_horizontal" 
android:layout_margin="5dp" 





android:textSize="16sp" /> 
</LinearLayout> 


</android,.support.v7.widget.CardView> 





这 里 使 用 了 CardView 来 作为 子 项 的 最 外 层 布局 ， 从 而 使 得 RecyclerView 
中 的 每 个 元 素 都 是 在 卡片 当中 的 。CardView 由 于 是 一 个 FrameLayout， 
因此 它 没 有 什么 Ca 的 定位 方式 ， 这 里 我 们 只 好 在 CardView 中 再 舱 套 一 
个 LinearLayout， 然 后 在 LinearLayout 中 放置 具体 的 内 容 。 


内 容 倒 也 没有 什么 特殊 的 地 方 ， 就 是 定义 了 一 个 ImageView 用 于 显示 水 
果 的 图 片 ， 又 定义 了 一 个 TextView 用 于 显示 水 果 的 名 称 ， 并 让 TextView 
在 水 平方 向 上 居中 显示 。 注 意 在 ImageView 中 我 们 使 用 了 一 个 scaleType 
属性 ， 这 个 属性 可 以 指定 图 片 的 缩放 模式 。 由 于 各 张 水 果 图 片 的 长 宽 比 
例 可 能 都 不 一 致 ， 为 了 让 所 有 的 图 片 都 能 填充 满 整 个 ImageView， 这 里 
使 用 了 centerCrop 模 式 ， 它 可 以 让 图 厂 保 持原 有 比例 填充 满 ImageView， 

并 将 超出 屏幕 的 部 分 裁剪 掉 。 


接 下 来 需要 为 RecyclerView 准 备 一 个 适配器 ， 新 建 FruitAdapter 类 ， 让 
这 个 适配器 继承 自 RecyclerView.Adapter， 并 将 泛 型 指定 为 
FruitAdapter.ViewHolder， 代 码 如 下 所 示 : 

















public class FruitAdapter extends RecyclerVview.Adapter<FruitAdapter .ViewHolder> { 
private Context mContext 
private List<Fruit> mFruitList; 


static class ViewHolder extends RecyclerView.ViewHolder { 
CardView cardView; 
ImageView fruitImage; 
TextView fruitName; 


public ViewHolder (View view) { 
super (view); 
cardView = (CardView) view; 
fruitImage = (ImageView) view.findViewById(R.id.fruit_ image); 
fruitName = (TextView) view.findViewById(R.id.fruit_name); 
} 
} 


public FruitAdapter(List<Fruit> fruitList) { 
mFruitList = fruitList; 


@override 
public ViewHolder onCreateViewHolder (ViewGroup parent, int viewType) { 
if (mContext == null) 
mContext = parent.getContext(); 


} 

View view = LayoutIinflater.from(mContext).inflate(R.layout.fruit_item, 
parent, false); 

return new ViewHolder (view); 


@override 
public void onBindViewHolder (ViewHolder holder, int position) { 
Fruit fruit = mFruitList.get(position); 
holder .fruitName.setText(fruit.getName()); 
Glide.with(mContext).load(fruit.getImageId()).into(holder.fruitImage); 
} 


@Override 
public int getItemCount() { 
return mFruitList.size(); 


} 














上 述 代 码 相信 你 一 定 很 熟悉 ， 和 我 们 在 第 3 章 中 编写 的 FruitAdapter 几 乎 
一 模 一 样 。 唯 一 需要 注意 的 是 ， 在 onBindviewHolder() 方 法 中 我 们 使 用 
了 Glide 来 加 载 水 果 图 片 。 


那么 这 里 惑 顺 便 来 看 一 下 Glide 的 用 法 吧 ， 其 实 并 没有 太 多 好 讲 的 ， 因 
为 Glide 的 用 法 实在 是 太 简 单 了 。 首 移 调 用 Glide.with() 方 法 并 传 入 一 
个 Context、 Activity 或 Fragment 人 参数 ， 然后 调用 load() 方 法 去 加 载 图 
片 ， 可 以 是 一 个 URL 地 址 ， 也 可 以 是 一 个 本 地 路 径 ， 或 者 是 一 个 资源 
id， 最 后 调用 into() 方 法 将 图 片 设 置 到 具体 某 一 个 ImageView 中 就 可 以 
本 


那么 我 们 为 什么 要 使 用 Glide 而 不 是 传统 的 设置 图 片 方式 呢 ? 因为 这 次 
我 从 网 上 找 的 这 上 坚 水 果 图 片 像素 者 非常 高 ， 如 果 不 进 行 压 缩 束 直接 展示 
的 话 ， 很 容易 就 会 引起 内 存 淤 出 。 而 使 用 Glide 束 完全 不 需要 担心 这 回 
事 ， 因 为 Glide 在 内 部 做 了 许多 非常 复杂 的 逻辑 操 作 ， 其 中 惑 包括 了 图 
片 压 缩 ， 我 们 只 需要 安心 按照 Glide 的 标准 用 法 去 加 载 图 片 就 可 以 了 。 


这 样 我 们 束 将 RecyclerView 的 适配器 也 准备 好 了 ， 最 后 修改 MainActivity 
中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 











private DrawerLayout mDrawerLayout; 


private Fruit[] fruits = {new Fruit("Apple", R.drawable.apple), new Fruit("Banana" 
R.drawable.banana), 

new Fruit("Orange", R.drawable.orange), new Fruit("Watermelon", R. 
drawable .watermelon) 

new Fruit("Pear", R.drawable.pear), new Fruit("Grape", R.drawable. 
grape), 

new Fruit("Pineapple", R.drawable.pineapple), new Fruit("Strawberry", 
R.drawable.strawberry), 

new Fruit("Cherry", R.drawable.cherry), new Fruit("Mango", R.drawable. 
mango)}; 


private List<Fruit> fruitList = new ArrayList<>(); 
private FruitAdapter adapter; 


@override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity main); 


initFruits(); 

RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recycler_view); 
GridLayoutManager layoutManager = new GridLayoutManager(this, 2) 
recyclerView.setLayoutManager (layoutManager); 

adapter = new FruitAdapter(fruitList); 

recyclerView.setAdapter (adapter); 


} 


private void initFruits() { 
fruitList.clear(); 
for (int i = ©; i < 50; i++) { 
Random random = new Random(); 
int index = random.nextInt(fruits.1length); 
fruitList.add(fruits[index]); 








在 MainActivity 中 我 们 首先 定义 了 一 个 数组 ， 数 组 里 面 存放 了 很 多 

个 Fruit 的 实例 ， 每 个 实例 都 代表 着 一 种 水 果 。 然 后 在 initFruits() 方 法 
中 ， 先 是 清空 了 一 下 fruitList 中 的 数据 ， 接 着 使 用 一 个 随机 函数 ， 从 

刚才 定义 的 Fruit 数 组 中 随机 挑选 一 个 水 果 放 入 到 fruitList 当 中 ， 这 样 
每 次 打开 程序 看 到 的 水 条 数据 都 会 是 不 同 的 。 另 外 ， 为 了 让 界面 上 的 数 
据 多 一 些 ， 这 里 使 用 了 一 个 循环 ， 随 机 挑选 50 个 水 果 。 


之 后 的 用 法 就 是 RecyclerView 的 标准 用 法 了， 不 过 这 里 使 用 了 
GridLayoutManager 这 种 布局 方式 。 在 第 3 章 中 我 们 已 经 学 过 了 
LinearLayoutManager 和 StaggeredGridLayoutManager， 现 在 终于 将 所 有 
的 布局 方式 都 补 齐 了 。GridLayoutManager 的 用 法 也 没有 什么 特别 之 
处 ， 它 的 构造 函数 接收 两 个 参数 ， 第 一 个 是 context， 第 二 个 是 列 数 ， 
这 里 我 们 希望 每 一 行 中 会 有 两 列 数据 。 


现在 重新 运行 一 下 程序 ， 效 果 如 图 12.13 所 示 。 























图 12.13 卡片 式 布局 效果 


可 以 看 到 ， 精 美的 水 果 图 片 成 功 展示 出 来 了 。 每 个 水 果 都 是 在 一 张 单独 
的 卡片 当中 的 ， 并 且 还 拥有 圆 朋 和 投影 ， 是 不 是 非常 美观 ? 另外 ， 由 于 
我 们 是 使 用 随机 的 方式 来 获取 水 果 数 据 的 ， 因 此 界面 上 会 有 一 些 重复 的 
水 果 出 现 ， 这 属于 正常 现象 。 


当 你 陶醉 于 当前 精美 的 界面 的 时 候 ， 你 是 不 是 忽略 了 一 个 细 市 ? 哎呀 ， 
我 们 的 Toolbar 怎 么 不 见 了 ! 仔细 观察 一 下 原来 是 被 RecyclerView 给 挡住 
了 。 这 个 问题 义 该 怎么 解决 昵 ?这 就 需要 借助 到 男 外 一 个 工具 了 
AppBarLayonut。 

















12.5.2 AppBarLayonut 


首先 我 们 来 分 析 一 下 为 什么 RecyclerView 会 把 Toolbar 给 遮挡 住 吧 。 其 实 
并 不 难 理解 ， 由 于 RecyclerView 和 Toolbar 都 是 放置 在 CoordinatorLayout 
中 的 ， 而 前 面 已 经 说 过 ，CoordinatorLayout 就 是 一 个 加 强 版 的 
FrameLayout， 那 么 FrameLayout 中 的 所 有 控件 在 不 进行 明确 定位 的 情况 
下 ， 默 认 都 会 摆 放 在 布局 的 左上 角 ， 从 而 也 就 产生 了 遮挡 的 现象 。 其 实 
这 已 经 不 是 你 第 一 次 遇 到 这 种 情况 了 ， 我 们 在 3.3.3 小 节 学 习 
FrameLayout 的 时 候 就 早已 见识 过 了 控件 与 控件 之 间 遮 挡 的 效 末 。 


既然 已 经 找到 了 问题 的 原因 ， 那 么 该 如 何 解 决 呢 ? 传 统 情况 下 ， 使 用 偏 
移 是 唯一 的 解决 办 法 ， 即 让 RecyclerView 向 下 偏 移 一 个 Toolbar 的 高 度 ， 
从 而 保证 不 会 遮挡 到 Toolbar。 不 过 我 们 使 用 的 并 不 是 普通 的 
FrameLayout， 而 是 CoordinatorLayout， 因 此 自然 会 有 一 些 更 加 巧妙 的 解 
决 办 法 。 


这 里 我 准备 使 用 Design Support 库 中 提供 的 男 外 一 个 工具 一 一 
AppBarLayout。AppBarLayout 实 际 上 是 一 个 垂直 方向 的 LinearLayout， 
它 在 内 部 做 了 很 多 深 动 事件 的 封装 ， 并 应 用 了 一 些 Material Design 的 设 
Cs 














那么 我 们 怎样 使 用 AppBarLayout 才 能 解决 前 面 的 宪 新 问题 昵 ?其 实 只 需 
要 两 步 束 可 以 了 ， 第 一 步 将 Toolbar 藤 套 到 AppBarLayout 中 ， 第 二 步 给 
RecyclerView 指 定 一 个 布局 行为 。 修 改 activity_main.xml 中 的 代码 ， 如 下 
所 示 : 


<android.support.v4.widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawer_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android.support.design.widget.CoordinatorLayout 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android.support.design.widget .AppBarLayout 
android:layout_width="match_parent" 
android:layout_height="wrap_content"> 





<android.support.v7.widget.Toolbar 

android:id="@+id/toolbar" 

android:layout_width="match_parent" 

android:layout_height="?attr/actionBarSize" 

android:background="?attr/colorPrimary" 

android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 

app:popupTheme="@style/ThemeOverlay.AppCompat .Light" /> 
</android,.support.design.widget.AppBarLayout> 


<android.support.v7.widget.RecyclerView 
android:id="@+id/recycler_view" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
app:layout_behavior="@string/appbar_scrolling_ view_ behavior" 


sw 
V 


</android,.support.design.widget.CoordinatorLayout> 


</android.support.v4.widget.DrawerLayout> 


可 以 看 到 ， 布 局 文件 并 没有 什么 太 大 的 变化 。 我 们 首先 定义 了 一 个 
AppBarLayout， 并 将 Toolbar 放 置 在 了 AppBarLayout 里 面 ， 然 后 在 
RecyclerView 中 使 用 app:layout_behavior 属 性 指定 了 一 个 布局 行为 。 其 
中 appbar_scrolling_view_behavior 这 个 字符 串 也 是 由 Design Support 库 
提供 的 。 


现在 重新 运行 一 下 程序 ， 你 束 会 发 现 一 切 都 正常 了 ， 如 图 12.14 所 示 。 





Pineapple 








图 12.14 解决 RecyclerView 谈 挡 Toolbar 的 问题 


虽说 使 用 AppBarLayout 已 经 成 功 解决 了 RecyclerView 遮 挡 Toolbar 的 问 


题 ， 但 是 刚才 有 提 到 过 ， 说 AppBarLayout 中 应 用 了 一 些 Material Design 
的 设计 理念 ， 好 像 从 上 面 的 例子 完全 体现 不 出 来 呀 。 事 实 上 ， 当 
RecyclerView 深 次 动 的 时 候 就 已 经 将 滚动 事件 都 通知 给 AppBarLayout 了 ， 

只 是 我 们 还 没 进行 处 理 而 已 。 那 么 下 面 就 让 我 们 来 进一步 优化 ， 看 看 
A 底 能 实现 什么 样 的 Material Design 效 果 。 


当 AppBarLayonut 接 收 到 滚动 事件 的 时 候 ， 它 内 部 的 子 控件 其 实 是 可 以 指 
定 如 何 去 影 响 这 些 事件 的 ， 通 过 app:1layout_scrol1L1Flags 属 性 就 能 实 
现 。 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<android.support.v4.widget.DrawerLayout 
xmlns: android= "http://schemas.android. com/apk/res/android" 
xmlns:app= "http: //schemas.android.com/apk/res-auto" 
android:id= "@trid/drawer_ layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 








<android.support.design.widget.CoordinatorLayout 
android:layout_width="match_paren 
android:layout_height="match_parent"> 


<android. support .design. widget -pea ay ou 
android:layout_width="match_pa 
android:layout_height="wrap_ Cn en > 


<android.support.v7.widget.Toolbar 

android:id="@+id/toolbar 
android:layout_width="match_parent" 
android:layout_height="?attr/actionBarSize" 
android:background="?attr/colorPrimary" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:popupTheme="@style/ThemeOverlay.AppCompat .Light" 
app:layout_scrollFlags="scroll|enterAlways|snap" /> 

</android,.support.design.widget.AppBarLayout> 





</android,.support.design.widget.CoordinatorLayout> 


</android,.support.v4.widget.DrawerLayout> 


这 里 在 Toolbar 中 添加 了 一 个 app:layout_scrollFlags 属 性 ， 并 将 这 个 属 
性 的 值 指 定 成 了 scroll|enterAlways|snap。 其 中 ， scroll 表 示 当 
RecyclerView| 可 上 深 动 的 时 候 ， Toolbar 会 跟着 一 起 向 上 滚动 并 实现 隐 
藏 ; enterAlways 表 示 当 RecyclerView 向 下 滚动 的 时 候 ，Toolbar 会 跟着 一 
起 向 下 滚动 并 重新 显示 。snap 表 示 当 Toolbar 还 没有 完全 隐藏 或 显示 的 时 
修 ， 会 根据 当前 深 动 的 距离 ， 目 动 选择 是 隐藏 还 是 显示 。 


我 们 要 改动 的 就 只 有 这 一 行 代码 而 已 ， 现 在 重新 运行 一 下 程序 ， 并 同上 
滚动 RecyclerView， 效 果 如 图 12.15 所 示 。 


























Pineapple 





图 12.15” 癌 上 滚动 RecyclerView 隐 茂 Toolbar 


可 以 看 到 ， 随 着 我 们 向 上 滚动 RecyclerView，Toolbar 竟 然 消 失 了 ， 而 向 
下 滚动 RecyclerView，Toolbar 又 会 重新 出 现 。 这 其 实 也 是 Material 
Design 中 的 一 项 重要 设计 思想 ， 因 为 当 用 户 在 同上 滚动 RecyclerView 的 
时 候 ， 其 注意 力 肯 定 是 在 RecyclerView 的 内 容 上 面 的 ， 这 个 时 候 如 果 
Toolbar 还 占据 着 屏 磊 空间 ， 束 会 在 一 定 程 度 上 影响 用 户 的 阅读 体验 ， 而 
将 Toolbar 隐 藏 则 可 以 让 阅读 体验 达到 最 佳 状 态 。 当 用 户 需 要 操作 
Toolbar 上 的 功能 时 ， 只 需要 轻微 向 下 滚动 ，Toolbar 就 会 重新 出 现 。 这 
种 设计 方式 ， 既 保证 了 用 户 的 最 佳 阅 读 效 果 ， 叉 不 影响 任何 功能 上 的 操 
作 ，Mtaterial Design 考 虑 得 就 是 这 么 细致 入 微 。 


当然 了 ， 像 这 种 功能 ， 如 果 是 使 用 ActionBar 的 话 ， 那 就 完全 不 可 能 实现 











了 ，Toolbar 的 出 现 为 我 们 提供 了 更 多 的 可 能 。 


12.6 ”下拉 刷新 


下 拉 刷 新 这 种 功能 早 惑 不 是 什么 新 鲜 的 东西 了 ， 几 乎 所 有 的 应 用 里 都 会 
有 这 个 功能 。 不 过 市 面 上 现 有 的 下 拉 刷 新 功能 在 风格 上 都 各 不 相同 ， 并 
且 和 Material Design 还 有 些 格格 不 入 的 感觉 。 因 此 ， 人 谷歌 为 了 让 Android 
的 下 拉 刷 新 风格 能 有 一 个 统一 的 标准 ， 于 是 在 Material Design 中 制定 了 
一 个 官方 的 设计 规范 。 当 然 ， 我 们 并 不 需要 去 深入 了 解 这 个 规范 到 底 是 
什么 样 的 ， 因 为 谷歌 早 就 提供 好 了 现成 的 控件 ， 我 们 只 需要 在 项 目 中 直 
接 使 用 就 可 以 了 。 


SwipeRefreshLayout 残 是 用 于 实现 下 拉 刷 新 功能 的 核心 类 ， 它 是 由 
support-v4 库 提供 的 。 我 们 把 想 要 实现 下 拉 刷 新 功能 的 控件 放置 到 
SwipeRefreshLayout 中 ， 束 可 以 迅速 让 这 个 控件 文 持 下 拉 刷 新 。 那 么 在 
MiaterialTest 项 目 中 ， 应 该 文 持 下 拉 刷 新 功能 的 控件 自然 就 是 
RecyclerView 了 。 


由 于 SwipeRefreshLayout 的 用 法 也 比较 简单 ， 下 面 我 们 就 直接 开始 使 用 
了 。 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<android.support.v4.widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawer_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 














<android.support.design.widget.CoordinatorLayout 
android:layout_ width="match_parent 
android:layout_height="match_parent"> 


<android.support.v4.widget.SwipeRefreshLayout 
android:id="@+id/swipe_refresh" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
app:layout_behavior="@string/appbar_scrolling _ view behavior"> 
<android.support.v7.widget.RecyclerView 
android:id="@+id/recycler_view" 
android:layout_width="match_parent" 
android:layout_height="match_parent" /> 
</android.support.v4.widget.SwipeRefreshLayout> 


</android.support.design.widget.CoordinatorLayout> 


</android.support.v4.widget.DrawerLayout> 


可 以 看 到 ， 这 里 我 们 在 RecyclerView 的 外 面 又 租 套 了 一 层 
SwipeRefreshLayout， 这 样 RecyclerView 就 自动 拥有 下 拉 刷 新 功能 了 。 另 





外 需要 注意 ， 由 于 RecyclerView 现 在 变 成 了 SwipeRefreshLayout 的 子 控 
件 ， 因 此 之 前 使 用 app:layout_behavior 声 明 的 布局 行为 现在 也 要 移 到 
SwipeRefreshLayout 中 才 行 。 


不 过 这 还 没有 结束 ， ee 下 拉 刷 新 功能 了 ， 但 是 
0 年代 码 中 处 理 具体 的 刷新 逻辑 才 行 。 修 改 MainActivity 中 的 代 
伍 ， 中 下 小: 


public class MainActivity extends AppCompatActivity { 








private SwipeRefreshLayout swipeRefresh; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity main); 


swipeRefresh = (SwipeRefreshLayout) findViewById(R.id.swipe_refresh); 
swipeRefresh.setColorSchemeResources(R.color.colorPrimary); 
swipeRefresh.setonRefreshListener(new SwipeRefreshLayout. 
OnRefreshListener() { 
@override 
public void onRefresh() { 
refreshFruits(); 


} 
}); 
} 


private void refreshFruits() { 
new Thread(new Runnable() { 
@override 
Puplie void run() { 


Thread.sleep(2000); 
} catch (InterruptedException e) { 
e.printSstackTrace(); 


runonUiThread(new Runnable() { 
@Override 
public void run() { 
initFruits(); 
adapter .notifyDatasetChanged(); 
swipeRefresh.setRefreshing(false); 
} 
}); 


} 
}).start(); 





这 段 代码 应 该 还 是 比较 好 理解 的 ， 首 先 通过 findviewById() 方 法 拿 到 
SwipeRefreshLayout 的 实例 ， 然 后 调用 setcolorschemeResources() 方 法 
来 设置 下 拉 刷 新 进度 条 的 颜色 ， 这 里 我 们 就 使 用 主题 中 的 colorPrimary 
作为 进度 条 的 颜色 了 。 接 着 调用 setonRefreshListener() 方 法 来 设置 一 
个 下 拉 刷 新 的 监听 器 ， 当 触发 了 下 拉 刷 新 操作 的 时 候 就 会 回调 这 个 监听 
308 然后 我 们 在 这 里 去 处 理 具体 的 刷新 逻辑 就 可 以 


通常 情况 下 ，onRefresh() 方 法 中 应 该 是 去 网 络 上 请 求 最 新 的 数据 ， 然 
后 再 将 这 些 数据 展示 出 来 。 这 里 简单 起 见 ， 我 们 就 不 和 网 络 进 和 S44 


了 ， 而 是 调用 一 -1 refreshFruits() 方 法 进行 本 地 刷新 操 

作 。refreshFruits() 方 法 中 先是 开启 了 一 个 线程 ， 然 后 将 线程 沉睡 两 秒 
钟 。 之 所 以 这 么 做 ， 是 因为 本 地 刷新 操作 速度 非常 快 ， 如 果 不 将 线程 沉 
睡 的 话 ， 刷 新 立刻 就 结束 了 ， 从 而 看 不 到 刷新 的 过 程 。 沉 睡 结束 之 后 ， 
这 里 使 用 了 runonuiThread() 方 法 将 线程 切换 回 主线 程 ， 然 后 调 

用 ;initFruits() 方 法 重新 生成 数据 ， 接 着 再 调用 FruitAdapter 的 
notifyDatasetCchanged() 方 法 通知 数据 发 生 了 变化 ， 最 后 调用 
SwipeRefreshLayout 的 setRefreshing() 方 法 并 传 入 false， 用 于 表示 刷新 
事件 结束 ， 并 隐藏 刷新 进度 条 。 


现在 可 以 重新 运行 一 下 程序 了 ， 在 屏幕 的 主 界面 问 下 拖 动 ， 会 有 一 个 下 
拉 刷 新 的 进度 条 出 现 ， 松 手 后 就 会 目 动 进行 刷新 了 ， 效 末 如 图 12.16 所 
外。 
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图 12.16 ”实现 下 拉 刷 新 效果 


下 拉 刷 新 的 进度 条 只 会 停留 两 秒 钟 ， 之 后 束 会 自动 消失 ， 界 面 上 的 水 果 
数据 也 会 随 之 更 新 。 


这 样 我们 就 把 下 拉 刷 新 的 功能 也 成 功 实 现 了 ， 并 且 这 就 是 Material 
Design 中 规定 的 最 标准 的 下 拉 刷 新 效果 ， 还 有 什么 会 比 这 个 更 好 看 呢 ? 
目前 我 们 的 项 目 中 已 经 应 用 了 众多 Material Design 的 效果 ，Design 
Support 库 中 的 常用 控件 也 学 了 大 半 了 。 不 过 本 章 的 学 习 之 旅 还 没有 结 
束 ， 在 最 后 的 尾声 部 分 ， 我 们 再 来 实现 一 个 非常 震撼 的 Material Design 
效果 一 一 可 折 苇 式 标题 栏 。 








12.7 可 折 著 式 标题 栏 


虽说 我 们 现在 的 标题 栏 是 使 用 Toolbar 来 编写 的 ， 不 过 它 看 上 去 和 传统 的 
ActionBar 其 实 没什么 两 样 ， 只 不 过 可 以 啊 应 RecyclerView 的 滚动 事件 来 
进行 隐藏 和 显示 。 而 Material Design 中 并 没有 限定 标题 栏 必须 是 长 这 个 
样子 的 ， 事 实 上 ， 我 们 可 以 根据 上 自己 的 喜好 随意 定制 标题 栏 的 样式 。 那 
么 本 节 中 我 们 就 来 实现 一 个 可 折 车 式 标 题 栏 的 效果 ， 需 要 借助 
CollapsingToolbarLayout 这 个 工具 。 














12.7.1 CollapsingToolbarLayout 


顾名思义 ，CollapsingToolbarLayout 是 一 个 作用 于 Toolbar 基 础 之 上 的 布 
局 ， 它 也 是 由 Design Support 库 提供 的 。CollapsingToolbarLayout 可 以 让 
Toolbar 的 效 末 变 得 更 加 丰富 ， 不 仅仅 是 展示 一 个 标题 栏 ， 而 是 能 够 实现 
非常 华丽 的 效果 。 


不 过 ，CollapsingToolbarLayout 是 不 能 独立 存在 的 ， 它 在 设计 的 时 候 就 
被 限定 只 能 作为 AppBarLayout 的 直接 子 布局 来 使 用 。 而 AppBarLayout 又 
必须 是 CoordinatorLayout 的 子 布局 ， 因 此 本 节 中 我 们 要 实现 的 功能 其 实 
需要 综合 运用 前 面 所 学 的 各 种 知识 。 那 么 话 不 多 说 ， 这 就 开始 吧 。 


首先 我 们 需要 一 个 额外 的 活动 来 作为 水 果 的 详情 展示 界面 ， 石 击 
com.example.materialtest 包 ,New Activity “Empty Activity， 创 建 一 个 
FruitActivity， 并 将 布局 名 指定 成 activity_fruit.xml， 然 后 我 们 开始 编写 
水 果 详 情 展 示 界 面 的 布局 。 


由 于 整个 布局 文件 比较 复杂 ， 这 里 我 准备 采用 分 段 编写 的 方式 。 
activity_fruit.xml 中 的 内 容 主要 分 为 两 部 分 ， 一 个 是 水 果 标题 栏 ， 一 个 是 
水 果 内 容 详 情 ， 我 们 来 一 步 步 实 现 。 


首先 实现 标题 栏 部 分 ， 这 里 使 用 CoordinatorLayout 来 作为 最 外 层 布 局 ， 
如 下 所 示 : 














roid:layout_height="match_parent"> 


</android.support.design.widget.CoordinatorLayout> 


一 开始 的 代码 还 是 比较 简单 的 ， 相 信 没 有 什么 需要 解释 的 地 方 。 注 意 始 
终 记 得 要 定义 一 个 xmlns:app 的 命名 空间 ， 在 Material Design 的 开发 中 会 
经 常用 到 它 。 


接着 我 们 在 CoordinatorLayout 中 舱 套 一 个 AppBarLayout， 如 下 所 示 : 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 
<android.support.design.widget .AppBarLayout 
android:id="@+id/appBar" 
android:layout_width="match_parent" 
android:layout_height="250dp"> 
</android,.support.design.widget.AppBarLayout> 


</android,.support.design.widget.CoordinatorLayout> 


目前 为 止 也 没有 什么 难 理解 的 地 方 ， 我 们 给 AppBarLayout 定 义 了 一 个 
id， 将 它 的 宽度 指定 为 match_parent， 高 度 指 定 为 250dp。 当 然 这 里 的 高 
度 值 你 可 以 随意 指定 ， 不 过 我 尝试 之 后 发 现 250dp 的 视觉 效果 比较 好 。 


接 下 来 我 们 在 AppBarLayout 中 再 能 套 一 个 CollapsingToolbarLayout， 如 
下 所 示 : 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 





xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android.support.design.widget .AppBarLayout 
android:id="@+id/appBar" 
android:layout_width="match_parent" 
android:layout_height="250dp"> 


<android.support.design.widget.CollapsingToolbarLayout 
android:id="@+id/collapsing_toolbar" 
android:layout_width="match_parent" 
android:layout_height="match_parent 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:contentScrim="?attr/colorPrimary" 
app:layout_scrollFlags="scroll|exitUntilCcollapsed"> 

</android.support.design.widget.CollapsingToolbarLayout> 





</android,.support.design.widget.AppBarLayout> 


</android,.support.design.widget.CoordinatorLayout> 


从 现在 开始 就 稍微 有 点 难 理解 了 ， 这 里 我 们 使 用 了 新 的 布局 
CollapsingToolbarLayout。 其 中 ，id、1layout_width 和 1layout_height 这 
几 个 属性 比较 简单 ， 我 就 不 解释 了 。android:theme 属 性 指定 了 一 个 
ThemeOverlay.AppCompat.Dark.ActionBar 的 主题 ， 其 实 对 于 这 部 分 我 们 


也 并 不 卫生， 因为 之 前 在 activity_main.xml 中 给 Toolbar 指 定 的 也 是 这 
个 主题 ， 只 不 过 这 里 要 实现 更 加 高 级 的 Toolbar 效 果 ， 因 此 需要 将 这 个 主 
题 的 指定 提 到 上 一 层 来 。app:contentscrim 属 性 用 于 指定 
CollapsingToolbarLayout 在 趋 于 折 著 状态 ee 登 之 后 的 背景 
CollapsingToolbarLayout 在 折 和 县 之 后 就 是 一 通 的 Toolbar， 那么 症 
色 肯 定 应 该 是 colorPrimary 了 ， i 会 儿 束 能 

到 。 app:layout_scrollFlags 属 性 我 们 也 是 见 过 的 ，; 只 不 过 是 给 
Toolbar 指 定 的 ， 现 在 也 移 到 外 面 来 了 。 其 中 ， Sie 让 
CollapsingToolbarLayout 会 随 着 水 果 内 容 详 情 的 滚动 一 起 深 

动 ， i eh te 
登 之 后 就 保留 在 界面 上 ， 不 再 移出 屏幕 


接 下 来 ， 我 们 在 CollapsingToolbarLayout 中 定义 标题 栏 的 具体 内 容 ， 如 
下 所 示 : 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 








<android.support.design.widget.AppBarLayout 
android:id="@+id/appBar 
android:layout_width="match_parent" 
android:layout_height="250dp"> 


<android. Support . design.widget :CollapsingToolbarLayout 
android:id= "@+id/collapsing- toolba 
android:layout_width="match_parent" 
android:layout_height="match_parent 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:contentScrim="?attr/colorPrimary" 
app:layout_scrollFlags="scroll|exitUntilCollapsed"> 





<ImageView 
android:id="@+id/fruit_image_view" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:scaleType="centerCrop" 
app:layout_collapseMode="parallax" /> 

<android.support.v7.widget.Toolbar 
android:id="@+id/toolbar" 
android:layout_width="match_parent" 
android:layout_height="?attr/actionBarSize" 
app:layout_collapseMode="pin" /> 

</android.support.design.widget.CollapsingToolbarLayout> 
</android,.support.design.widget.AppBarLayout> 


</android,.support.design.widget.CoordinatorLayout> 


可 以 看 到 ， 我 们 在 CollapsingToolbarLayout 中 定义 J 一 个 ImageView 和 一 
个 Toolbar， 也 束 意 味 着 ， 这 个 高 级 版 的 标题 栏 将 是 由 普通 的 标题 栏 加 上 
图 片 组 合 而 成 的 。 这 里 定义 的 大 多 数 属 性 我 们 都 是 见 过 的 ， 束 不 再 解释 
二 只 有 一 | app:layout_collapseMode 比 较 陌 生 。 它 用 于 指定 当前 控件 
在 CollapsingToolbarLayout 折 车 过 程 中 的 折 车 模式 ， 其 中 Toolbar 指 定 成 

pin， 表 示 在 折 闭 的 过 程 中 位 置 始 终 保持 不 变 ，ImageView 指 定 成 


parallax， 表 示 会 在 折合 的 过 程 中 产生 一 定 的 错位 偏 移 ， 这 种 模式 的 视 
党 效果 会 非常 好 。 


这 样 我 们 就 将 水 果 标 题 栏 的 界面 编写 完成 了 ， 下 面 开 始 编写 水 果 内 容 详 
情 部 分 。 继 续 修 改 activity_fruit.xml 中 的 代码 ， 如 下 所 示 : 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android.support.design.widget.AppBarLayout 
android:id="@+id/appBar" 
android:layout_width="match_parent" 
android:layout_height="250dp"> 


</android,.support.design.widget.AppBarLayout> 





<android.support.v4.widget.NestedScrollView 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
app:layout_behavior="@string/appbar_scrolling _ view behavior"> 


</android,.support.v4.widget.NestedScrollView> 


</android,.support.design.widget.CoordinatorLayout> 





水 采 内 容 详情 的 最 外 层 布局 使 用 了 一 个 NestedScrollView， 注 意 它 和 
AppBarLayout 是 平 级 的 。 我 们 之 前 在 9.2.1 小 节 和 学 过 ScrollView 的 用 法 ， 
它 人 允许 使 用 滚动 的 方式 来 查看 屏幕 以 外 的 数据 ， 而 NestedScrollView 在 
此 基础 之 上 还 增加 了 藤 套 响应 滚动 事件 的 功能 。 由 于 CoordinatorLayonut 
本 身 已 经 可 以 响应 滚动 事件 了 ， 因 此 我 们 在 它 的 内 部 就 需要 使 用 
NestedScrollView 或 RecyclerView 这 样 的 布局 。 另 外 ， 这 里 还 通过 
app:layout_behavior 属 性 指定 了 一 个 布局 行为 ， 这 和 之 前 在 
RecyclerView 中 的 用 法 是 一 模 一 样 的 。 





不 管 是 ScrollView 还 是 NestedScrollView， 它 们 的 内 部 都 只 人 允许 存在 一 个 
直接 子 布局 。 因 此 ， 如 果 我 们 想 要 在 里 面 放 入 很 多 东西 的 话 ， 通 常 都 会 
先 藤 套 一 个 LinearLayout， 然 后 再 在 LinearLayout 中 放 入 具体 的 内 容 束 可 
以 了 ， 如 下 所 示 : 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android.support.v4.widget.NestedScrollView 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
app:layout_behavior="@string/appbar_scrolling_ view behavior"> 


<LinearLayout 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="wrap_content"> 
</LinearLayout> 


</android,.support.v4.widget.NestedScrollView> 


</android,.support.design.widget.CoordinatorLayout> 


这 里 我 们 藤 套 了 一 个 垂直 方向 的 LinearLayout， 并 将 layout_width 设 置 
为 match_parent， 将 layout_height 设 置 为 wrap_content。 


接 下 来 在 LinearLayout 中 放 入 具体 的 内 容 ， 这 里 我 准备 使 用 一 个 
0 的 内 容 详情 ， 并 将 TextView 放 在 一 个 卡片 式 布 局 当 
， 如 下 上 所 示 : 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android.support.v4.widget.NestedScrollView 
android:layout_width="match_parent" 
android:layout_height="match_parent 
app:layout_behavior="@string/appbar_scrolling view_ behavior"> 


<LinearLayout 
android:layout_width="match_parent" 
android:1layout_ height=" ‘match_parent" 
android:orientation="vertical"> 


<android.support.v7.widget.CardView 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:layout_marginBottom="15dp" 
android:layout_marginLeft="15dp" 
android:layout_marginRight="15dp" 
android:layout_marginTop="35dp" 
app:cardCornerRadius="4dp"> 





<TextView 
android:id="@+id/fruit_content_text" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_margin="10dp" /> 
</android.support.v7.widget.CardView> 





</LinearLayout> 
</android,.support.v4.widget.NestedScrollView> 


</android.support.design.widget.CoordinatorLayout> 








这 段 代码 也 没有 什么 难 理解 的 地 方 ， 都 是 我 们 学 过 的 知识 。 需 要 注意 的 
是 ， 这 里 为 了 让 界面 更 加 美观 ， 我 在 CardView 和 TextView 上 都 加 了 一 些 


边 距 。 其 中 ，CardView 的 marginTop 加 了 35dp 的 边 距 ， 这 是 为 下 面 要 编 
写 的 东西 留 出 空间 。 





好 的 ， 这 样 束 把 水 果 标 题 栏 和 水 果 内 容 详情 的 界面 都 编写 完了 ， 不 过 我 
们 还 可 以 在 界面 上 再 谎 加 一 个 巧 浮 按钮 。 这 个 巧 序 按钮 并 不 是 必需 的 ， 
根据 具体 的 需求 添加 就 可 以 了 ， 如 有 果 加 入 的 话 ， 我 们 将 免费 获得 一 些 额 
外 的 动画 效果 。 


为 了 做 出 示范 ， 我 就 准备 在 activity_fruit,xml 中 加 入 一 个 悬浮 按钮 了 。 这 
个 界面 是 一 个 水 果 详 情 展 示 界 面 ， 那 么 我 就 加 入 一 个 表示 评论 作用 的 其 
浮 按 钮 吧 。 首 先 需要 提前 准备 好 一 个 图 标 ， 这 里 我 放置 了 一 张 
ic_comment.png 到 drawable-xxhdpi 目 录 下。 然后 修改 activity_fruit.xml 中 
的 代码 ， 如 下 所 示 : 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android. support.design.widget .AppBarLayout 
android:id="@+id/appBar" 
android:layout_width="match_parent" 
android:layout_height="250dp"> 


</android,.support.design.widget.AppBarLayout> 


<android.support.v4.widget.NestedScrollView 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
app:layout_behavior="@string/appbar_scrolling_ view_ behavior"> 





</android,.support.v4.widget.NestedScrollView> 


<android.support.design.widget.FloatingActionButton 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_margin="16dp" 
android:src="@drawable/ic_comment" 
app:layout_anchor="@id/appBar" 
app:layout_anchorGravity="bottom|end" /> 





</android.support.design.widget.CoordinatorLayout> 


可 以 看 到 ， 这 里 加 入 了 一 个 FloatingActionButton， 它 和 AppBarLayout 以 
及 NestedScrollView 是 平 级 的 。FloatingActionButton 中 使 

用 app:1layout_anchor 属 性 指定 了 一 个 锚 点 ， 我 们 将 锚 点 设置 为 
AppBarLayout， 这 样 晤 浮 按钮 束 会 出 现在 水 果 标 题 栏 的 区 域内 ， 接 着 又 
使 用 app: layout_anchorGravity 属 性 将 悬浮 按钮 定位 在 标题 栏 区域 的 右 
下 角 。 其 他 一 些 属性 都 比较 简单 ， 融 不 再 进行 解释 了 。 


好 了 ， 现 在 我 们 终于 将 整个 activity_fruit.xml 布 局 都 编写 完了 ， 内 容 虽 然 
比较 长 ， 但 由 于 是 分 段 编 写 的 ， 并 且 每 一 步 我 都 进行 了 详细 的 说 明 ， 相 
信 你 应 该 看 得 很 明白 吧 。 


界面 完成 了 之 后 ， 接 下 来 我 们 开始 编写 功能 逻辑 ， 修 改 FruitActivity 中 
的 代码 ， 如 下 所 示 : 


public class FruitActivity extends AppCompatActivity { 

















public static final String FRUIT_NAME = "fruit_name"; 
public static final String FRUIT_IMAGE_ID = "fruit_ image_id"; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity_fruit); 
Intent intent = getIintent(); 


String fruitName = intent.getStringExtra(FRUIT_NAME) ) 

int fruitImageId = intent.getIntExtra(FRUIT_IMAGE_ID, 0); 

Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar); 

CollapsingToolbarLayout collapsingToolbar = (CollapsingToolbarLayout) 
findViewById(R.id.collapsing_toolbar); 

ImageView fruitImageView = (ImageView) findViewById(R.id.fruit_ image_ view); 

TextView fruitContentText = (TextView) findViewById(R.id.fruit_content_ 


’ 
setSupportActionBar (toolbar); 
ActionBar actionBar = getSupportActionBar(); 
if (actionBar != null) { 

actionBar .setDisplayHomeAsUpEnabled(true) ， 


} 

collapsingToolbar.setTitle(fruitName); 
Glide.with(this).load(fruitImageId).into(fruitImageView); 
String fruitContent = generateFruitContent(fruitName); 
fruitContentText.setText(fruitContent); 


} 


private String generateFruitContent(String fruitName) { 
StringBuilder fruitContent = new StringBuilder(); 
for (int i = 0; i < 500; i++) { 
fruitContent.append(fruitName); 





} 
return fruitContent.toString(); 


} 


@Override 
public boolean onOptionsItemSelected(MenuItem item) { 
Switch (item.getItemId()) { 
case android.R.id.home: 
finish(); 
return true; 


} 
return super.onOptionsItemSelected(item); 





FruitActivity 中 的 代码 并 不 是 很 复杂 。 首 先 ， 在 oncreate() 方 法 中 ， 我 们 
通过 Intent 获 取 到 传 入 的 水 果 名 和 水 果 图 片 的 资源 id， 然 后 通过 
findviewById() 方 法 拿 到 刚才 在 布局 文件 中 定义 的 各 个 控件 的 实例 。 接 
痢 就 是 使 用 了 Toolbar 的 标准 用 法 ， 将 它 作 为 ActionBar 显 示 ， 并 局 用 
HomeAsUp 按 钮 。 由 于 HomeAsUp 按 钮 的 默认 图 标 惑 是 一 个 返回 箭头 ， 
这 正 是 我 们 所 期 望 的 ， 因 此 残 不 用 再 额外 设置 别 的 图 标 了 。 


接 下 来 开始 填充 界面 上 的 内 容 ， 调 用 CollapsingToolbarLayout 的 
setTitle() 方 法 将 水 果 名 设置 成 当前 界面 的 标题 ， 然 后 使 用 Glide 加 载 传 
入 的 水 果 图 片 ， 并 设置 到 标题 栏 的 ImageView 上 面 。 接 着 需要 填充 水 果 
的 内 容 详 情 ， 由 于 这 只 是 一 个 示例 程序 ， 并 不 需要 什么 真实 的 数据 ， 所 
以 我 使 用 了 一 个 generateFruitcontent() 方 法 将 水 果 名 循环 拼接 500 次 ， 
从 而 生成 了 一 个 比较 长 的 字符 串 ， 将 它 设置 到 了 TextView 上 面 。 


最 后 ， 我 们 在 onoptionsItemselected() 方 法 中 处 理 了 HomeAsUp 按 钮 的 
点 击 事 件 ， 当 点 击 了 这 个 按钮 时 ， 束 调用 finish() 方 法 关闭 当前 的 活 
动 ， 从 而 返回 上 一 个 活动 。 


所 有 工作 都 完成 了 吗 ? 其 实 还 差 最 关键 的 一 步 ， 就 是 处 理 RecyclerView 
的 点 击 事件 ， 不 然 的 话 我 们 根本 就 无 法 打开 FruitActivity。 修 改 
FruitAdapter 中 的 代码 ， 如 下 所 示 : 














public class FruitAdapter extends RecyclerView.Adapter<FruitAdapter.ViewHolder> { 


@override 
public ViewHolder onCreateViewHolder (ViewGroup parent, int viewType) { 
if (mContext == null) { 
mContext = parent.getContext(); 


View view = LayoutIinflater.from(mContext).inflate(R.layout.fruit_item, 
parent, false); 
final ViewHolder holder = new ViewHolder (view); 
holder .cardView.setonClickListener(new View.OnClickListener() { 
@override 
public void onClick(View v) { 
int position = holder.getAdapterPosition(); 
Fruit fruit = mFrultEiSt: get (position); 
Intent intent = new Intent(mContext, FruitActivity.class); 
intent.putExtra(FruitActivity.FRUIT_NAME, fruit.getName()); 
intent.putExtra(FruitActivity.FRUIT_IMAGE_ID, fruit.getIimageId()); 
mContext.startActivity(intent); 


}); 
return holder; 


最 关键 的 一 步 其 实 也 是 最 简单 的 ， 这 里 我 们 给 CardView 注 册 了 一 个 点 击 
事件 监听 器 ， 然 后 在 点 击 事 件 中 获取 当前 点 击 项 的 水 果 名 和 水 果 图 片 资 
源 id， 把 它们 传 入 到 Intent 中 ， 最 后 调用 startActivity() 方 法 启动 
FruitActivity 。 














见证 奇迹 的 时 刻 到 了 ， 现 在 重新 运行 一 下 程序 ， 并 点 击 界 面 上 的 任意 一 
个 水 末 ， 比 如 我 点 击 了 和 葡萄， 效果 如 几 12.17 所 示 。 
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图 12.17 水 果 的 详情 展示 界面 


你 没有 看 错 ， 如 此 精美 的 界面 就 是 我 们 杀手 敲 出 来 的 。 这 个 界面 上 的 内 
容 分 为 三 部 分 ， 水 果 标 题 栏 、 水 果 内 容 详情 和 悬浮 按钮 ， 相 信 你 一 眼 就 
能 将 它们 区 分 出 来 吧 。Toolbar 和 水 果 背 景 图 完美 地 融合 到 了 一 起 ， 既 保 
证 了 图 片 的 展示 空 x 间 ， 又 不 影响 Toolbar 的 任何 功能 ， 那 个 辐 左 的 箭头 就 
是 用 来 返回 上 一 个 活动 的 。 


不 过 这 并 不 是 全 部 ， 真 正 的 好 戏 还 在 后 头 。 我 们 答 试 同上 拖 动 水 果 内 容 
详情 ， 你 会 发 现 水 果 背 景 图 上 的 标题 会 慢 慢 缩小 ， 并 且 背 景 图 会 产生 一 
些 错 位 偏 移 的 效果 ， 如 图 12.18 所 示 。 
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图 12.18 向 上 拖 动 水 果 内 容 详情 


这 是 由 于 用 户 想 要 查看 水 果 的 内 容 详情 ， 此 时 界面 的 重点 在 具体 的 内 容 


上 面 ， 因 此 标题 栏 就 会 目 动 进行 打 登 ， 从 而 节省 屏幕 空间 。 
继续 各 上 拖 动 ， 直 到 标题 栏 变 成 完全 折合 状态 ， 效 果 如 图 12.19 所 示 。 











图 12.19 标题 栏 变 成 完全 折 双 状态 


可 以 看 到 ， 标 题 栏 的 背景 图 片 不 见 了 ， 苦 浮 按钮 也 自动 消失 了 ， 现 在 水 
果 标 题 栏 变 成 了 一 个 最 普通 的 Toolbar。 这 是 由 于 用 户 正 在 阅读 具体 的 内 
容 ， 我 们 需要 给 他 们 提供 最 充分 的 阅读 空间 。 而 如 果 这 个 时 候 癌 下 拖 动 
水 果 内 容 详情 ， 就 会 执行 一 个 完全 相反 的 动画 过 程 ， 最 终 恢 复 成 图 
12.17 的 界面 效果 。 


不 知道 你 有 没有 被 这 个 效果 所 感动 呢 ? 在 这 里 ， 我 真心 地 感谢 Material 
Design 送 给 我 们 的 礼物 。 


12.7.2 ”充分 利用 系统 状态 栏 空间 





虽说 现在 水 条 详 情 展示 界面 的 效果 已 经 非常 华丽 了 ， 但 这 并 不 代表 我 们 
不 能 再 进一步 地 提升 。 观 察 一 下 图 12.17， 你 会 发 现 水 果 的 背景 图 片 和 
系统 的 状态 栏 总 有 一 些 不 搭 的 感觉 ， 如 果 我 们 能 将 背景 图 和 状态 栏 融 合 
到 一 起 ， 那 这 个 视觉 体验 绝对 能 提升 好 几 个 档次 。 


只 不 过 很 可 惜 的 是 ， 在 Android 5.0 系 统 之 前 ， 我 们 是 无 法 对 状态 栏 的 背 
景 或 颜色 进行 操作 的 ， 那 个 时 候 也 还 没有 Material Design 的 概念 。 但 是 
Android 5.0 及 之 后 的 系统 都 是 文 持 这 个 功能 的 ， 因 此 这 里 我 们 就 来 实现 
一 个 系统 差异 型 的 效果 ， 在 Android 5.0 及 之 后 的 系统 中 ， 使 用 背景 图 和 
状态 栏 融合 的 模式 ， 在 之 前 的 系统 中 使 用 普通 的 模式 。 


想 要 让 背景 网 能 够 和 系统 状态 栏 融 合 ， 需 要 借助 
android:fitsSystemwindows 这 个 属性 来 实现 。 在 CoordinatorLayont、 
AppBarLayout、CollapsingToolbarLayout 这 种 般 套 结构 的 布局 中 ， 将 控 
件 的 android:fitssystemwindows 属 性 指定 成 true， 就 表示 该 控件 会 出 现 
在 系统 状态 栏 里 。 对 应 到 我 们 的 程序 ， 那 就 是 水 果 标 题 栏 中 的 
ImageView 应 该 设置 这 个 属性 了 。 不 过 只 给 ImageView 设 置 这 个 属性 是 
没有 用 的 ， 我 们 必须 将 ImageView 布 局 结构 中 的 所 有 父 布局 都 设置 上 这 
个 属性 才 可 以 ， 修 改 activity_fruit.xml 中 的 代码 ， 如 下 所 示 : 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:fitsSystemWindows="true"> 








<android.support.design.widget .AppBarLayout 
android:id="@+id/appBar" 
android:layout_width="match_parent" 
android:layout_height="250dp" 
android:fitsSystemwindows="true"> 


<android.support .design.widget.CollapsingToolbarLayout 
android:id="@+id/collapsing_toolbar" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
android:fitsSystemWindows="true" 
app:contentScrim="?attr/colorPrimary" 
app:layout_scrollFlags="scroll|exitUntilCollapsed"> 


<ImageView 
android:id="@+id/fruit_image_view" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:scaleType="centerCrop" 
android:fitsSystemWindows="true" 
app:layout_collapseMode="parallax" /> 


</android.support.design.widget.CollapsingToolbarLayout> 


</android,.support.design.widget.AppBarLayout> 


</android,.support.design.widget.CoordinatorLayout> 


但 是 ， 即 使 我 们 将 android:fitssystemwindows 属 性 都 设置 好 了 还 是 没有 





用 的 ， 因 为 还 必须 在 程序 的 主题 中 将 状态 栏 颜 色 指定 成 透明 色 才 行 。 指 
定 成 透明 色 的 方法 很 简单 ， 在 主题 中 将 android:statusBarcolor 属 性 的 
值 指 定 成 @android:color/transparent 就 可 以 了 。 但 问题 在 

于 ，android:statusBarcolor 这 个 属性 是 从 API 21， 也 束 是 Android 5.0 
系统 开始 才 有 的 ， 之 前 的 系统 无 法 指定 这 个 属性 。 那 么 ， 系 统 差 异型 的 
功能 实现 就 要 从 这 里 开始 了 。 


右 击 res 目 录 - New -Directory， 创 建 一 个 values-v21 目 录 ， 然 后 右 击 
values-v21 日 录 New -Values resource file， 创 建 一 个 styles.xml 文 件 。 
接着 对 这 个 文件 进行 编写 ， 代 码 如 下 所 示 : 


<resources> 


<style name= "FruitActivityTheme” parent="AppThe 
<item name="android:statusBarColor" Soo a hoa </item> 
</style> 


</resources> 


这 里 我 们 定义 了 一 个 FruitActivityTheme 主 是 ， 它 是 专门 给 FruitActivity 
使 用 的 。FruitActivityTheme 的 Be AppTheme， 也 束 是 说 ， 它 继 
承 了 AppTheme 中 的 所 有 特性 。 然 后 我 们 在 FruitActivityTheme 中 将 状态 
栏 的 颜色 指定 成 透明 色 ， 由 了 SeeS 2d 目录 是 只 有 Android 5.0 及 以 上 
的 系统 才 会 去 读 取 的 ， 因 此 这 么 声明 是 没有 问题 的 。 


但 是 Android 5.0 之 前 的 系统 却 无 法 识别 FruitActivityTheme 这 个 主题 ， 
此 我 们 还 需要 对 values/styles.xml 文 件 进行 修改 ， 如 下 所 示 : 


<resources> 





<!-- Base application theme. --> 
<style name="AppTheme" parent="Theme. eEPConpa Light.NoActionBar" 
-- Customize your theme here 
te name="colorPrimary" Sco r/c ond ba </item 
<item name="colorPrimaryDark" SO ol or /elor pr na vbar ke </item> 
<item name="colorAccent">@color/colorAccent</item> 
</style> 


<style name="FruitActivityTheme" parent="AppTheme"> 
</style> 


</resources> 


可 以 看 到 ， 这 里 也 定义 了 一 个 FruitActivityTheme 主 题 ， 并 且 parent 主 题 
也 是 AppTheme， 但 是 它 的 内 部 是 是 空 的 。 国力 Ahadioid 5.0 之 前 的 系统 无 
法 指定 状态 栏 的 颜色 ， 因 此 这 里 什么 都 不 用 做 就 可 以 了 。 


最 后 ， 我 们 还 需要 让 FruitActivity 使 用 这 个 主题 才 可 以 ， 修 改 





AndroidManifest.xml 中 的 代码 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.materialtest"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<activity 
android:name=" .FruitActivity" 
android:theme="@style/FruitActivityTheme"> 
</activity> 
</application> 


</manifest> 


这 里 使 用 android:theme 属 性 单独 给 FruitActivity 指 定 了 
FruitActivityTheme 这 个 主题 ， 这 样 我 们 就 大 功 告 成 了 。 


现在 只 要 是 在 Android 5.0 及 以 上 的 系统 运行 MaterialTest 程 序 ， 水 果 详 情 
展示 界面 的 效果 就 会 如 图 12.20 所 示 。 
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图 12.20 ”背景 图 和 状态 栏 融 合 的 效果 


相信 我 ， 再 对 比 一 下 图 12.17 的 效果 ， 这 两 种 视觉 体 验 绝对 不 是 在 一 个 
档次 上 的 。 


12.8 ”小 结 与 点 评 


学 完了 本 章 的 所 有 知识 ， 你 有 没有 觉得 无 比 兴 奋 呢 ? 反正 我 是 这 人 么 党 得 
的 。 本 章 我 们 的 收获 实在 是 太 多 了 ， 从 一 个 什么 都 没有 的 空 项 目 ， 经 过 
一 章 的 学 习 ， 最 后 实现 了 一 个 功能 如 此 丰富 、 界 面 如 此 华丽 的 应 用 ， 还 
有 什么 事情 比 这 个 更 让 我 们 有 成 就 感 吗 ? 


本 章 中 我 们 充分 利用 了 Design ”Support 库 、support-v4 库 、appcompat-v7 
库 ， 以 及 一 些 开源 项 目 来 实现 一 个 了 高 度 Material 化 的 应 用 程序 ， 能 将 
这 些 库 中 的 相关 控件 熟练 掌握 ， 你 的 Material Design 技术 就 算是 合格 
Ee 


不 过 说 到 底 ， 我 仍然 还 是 在 以 一 个 开发 者 的 思维 给 你 讲解 Material 
Design， 侧 重 于 如 何 去 实 现 这 些 效果 。 而 实际 上 ，Material Design 的 设 
计 思 维和 设计 理念 才 是 更 加 重要 的 东西 ， 当 然 这 部 分 内 容 应 该 是 UI 设计 
人 员 去 学 习 的 ， 如 果 你 也 感 兴趣 的 话 ， 可 以 参考 一 下 Material Design 的 
官方 文章 : https:/material.google.com 。 


现在 你 已 经 足 足 学 习 了 12 章 的 内 容 ， 对 Android 应 用 程序 开发 的 理解 应 
该 比较 深刻 了 。 目 前 系统 性 的 知识 几乎 都 已 经 讲 完了 ， 但 是 还 有 一 些 零 
散 的 高 级 技巧 在 等 待 着 你 ， 那 么 就 让 我 们 赶快 进入 到 下 一 章 的 学 习 当中 
吧 。 




















你 还 应 该 掌握 





第 13 章 继续 进 阶 
的 高 级 技巧 
本 书 的 内 容 虽 然 已 经 接近 尾声 了 ， 但 是 千 万 不 要 因此 而 放松 ， 现 在 正 是 


你 继续 进 阶 的 时 机 。 相 信 基 础 性 的 Android 知 识 已 经 没有 太 多 能 够 难 倒 
你 的 了 ， 那 么 本 章 中 我 们 就 来 学 习 一 些 你 还 应 该 掌握 的 高 级 技巧 吧 。 








13.1 全 局 获取 Context 的 技巧 


回想 这 么 久 以 来 我 们 所 学 的 内 容 ， 你 会 发 现 有 很 多 地 方 都 需要 用 到 
Context， 弹 出 Toast 的 时 候 需 要 ， 局 动 活动 的 时 候 需 要 ， 发 送 广播 的 时 


等 等 等 等 。 


候 需 要 ， 操 作 数 据 库 的 时 候 需 要 ， 使 用 通知 的 时 候 需 要 ， 等 等 等 等 


或 许 目前 你 还 没有 为 得 不 到 context 而 发 悉 过 ， 因 为 我 们 很 多 的 操作 都 
是 在 活动 中 进行 的 ， 而 活动 本 里 就 是 一 个 context 对 象 。 但 是 ， 当 应 用 
程序 的 架 向 逐 簿 渐 开 始 复杂 起 来 的 时 候 ， 很 多 的 逻辑 代码 都 将 脱离 
Activity 类 ， 但 此 时 你 又 恰恰 需要 使 用 context， 也 许 这 个 时 候 你 就 会 感 


到 有 些 伤 脑筋 了 。 


、 在 第 9 章 的 最 佳 实践 环节 ， 我 们 编写 了 一 个 Httputil 
在 这 里 将 一 些 通用 的 网 络 操作 封装 了 起 来 ， 代 码 如 下 所 示 : 


public class HttpUtil { 














public static void sendHttpRequest(final String address, final 
HttpCallbackListener listener) 
new Thread(new Runnable() { 
@override 
public void run() { 
HttpURLConnection connection = null; 
try { 
URL url = new URL(address); 
connection = (HttpURLConnection) url.openConnection(); 
connection.setRequestMethod( "GET"); 
connection.setCconnectTimeout(8000); 
connection.setReadTimeout(8000); 
connection.setDoInput(true); 
connection.setDoOutput (true); 
InputStream in = connection.getInputStream(); 
BufferedReader reader = new BufferedReader (new 
InputStreamReader (in)); 
StringBuilder response = new StringBuilder(); 
String line; 
while ((line = reader.readLine()) != null) { 
response.append(line); 


} 

if (listener != null) { 
// 回调 onFinish( ) 方 法 
listener.onFinish(response.toString()); 





} 
} catch (Exception e) { 
if (listener != null) { 
// 回调 onError() 方 法 
listener .onError(e); 











} 
} finally { 
if (connection != null) { 
connection.disconnect(); 
} 
} 


} 
}).start(); 








这 里 使 用 sendHttpRequest() 方 法 来 发 送 HTTP 请 求 显然 是 没有 问题 的 ， 


并 且 我 们 还 可 以 在 回调 方法 中 处 理 服务 器 返回 的 数据 。 但 现在 我 们 想 对 
sendHttpRequest() 方 法 进行 一 些 优化 ， 当 检测 到 网 络 不 存在 的 时 候 就 给 
用 户 一 个 Toast 提 示 ， 并 且 不 再 执行 后 面 的 代码 。 看 似 一 个 挺 简 单 的 功 
能 ， 可 是 却 存在 一 个 让 人 头疼 的 问题 ， 弹 出 Toast 提 示 需 要 一 个 context 
参数 ， 而 我 们 在 Httputil 类 中 显然 是 获取 不 到 context 对 象 的 ， 这 该 怎么 
办 呢 ? 


其 实 和 要 想 快 速 解决 这 个 问题 也 很 简单 ， 大 不 了 在 sendhttpRequest () 方 法 
中 添加 一 个 context 参 数 就 行 了 呆 ， 于 是 可 以 将 Httputil 中 的 代码 进行 如 
下 修改 : 


public class HttpUtil { 








public static void sendHttpRequest(final Context context, 
final Strin ress, final HttpCallbackListener listener) { 
if (!isNetworkAvailable()) { 
Toast .makeText "network is unavailable" 
Toast .LENGTH_SHORT) .show() ; 
tir 


} 
new Thread(new Runnable() { 
@override 
public void run() { 


ee 
}).start(); 


private static boolean isNetworkAvailable() { 


} 





可 以 看 到 ， 这 里 在 方法 中 添加 了 一 个 context 参 数 ， 并 且 假 设 有 一 
个 isNetworkAvailable() 方 法 用 于 判断 当前 网 络 是 否 可 用 ， 如 果 网 络 不 
可 用 的 话 束 弹出 Toast 提 示 ， 并 将 方法 return 挥 。 


虽说 这 也 确实 是 一 种 解决 方案 ， 但 是 却 有 点 推卸 责任 的 嫌疑 ， 因 为 我 们 
将 获取 context 的 任务 转移 给 了 sendHttpRequest() 方 法 的 调用 方 ， 至 于 
调用 方 能 不 能 得 到 context 对 象 ， 那 就 不 是 我 们 需要 考虑 的 问题 了 。 


由 此 可 以 看 出 ， 在 某 些 情况 下 ， 获 取 context 并 非 是 那么 容易 的 一 件 
事 ， 有 了 时候 还 是 挺 伤 脑筋 的 。 不 过 别 担心 ， 下 面 我 们 就 来 学 习 一 种 技 
巧 ， 让 你 在 项 目 的 任何 地 方 都 能 够 轻松 获取 到 context o 


Android 提 供 了 一 个 Application 关 ， 每 当 应 用 程序 启动 的 时 候 ， 系 统 束 
会 目 动 将 这 个 类 进行 初始 化 。 而 我 们 可 以 定制 一 个 自己 的 Application 
类 ， 以 便于 管理 程序 内 一 些 全 局 的 状态 信息 ， 比 如 说 全 局 context。 

















定制 一 个 自己 的 Application 其 实 并 不 复杂 ， 上 站 先 我 们 需要 创建 一 
个 MyApplication 类 继承 自 AppLication， 代码 如 下 所 示 : 


public class MyApplication extends Application { 
private static Context context; 
@Override 
public void onCreate() 


{ 
context = getApplicationContext(); 
} 


public static Context getContext() { 
return context,; 


} 


可 以 看 到 ，MyApplication 中 的 代码 非常 简单 。 这 里 我 们 重 写 了 父 类 的 
oncreate() 方 法 ， 并 通过 调用 getApplicationcontext() 方 法 得 到 了 一 个 
应 用 程序 级 别 的 context， 然 后 义 提 供 了 一 个 静态 的 getcontext() 方 法 ， 
在 这 里 将 刚才 获取 到 的 context 进 行 返回 。 


接 下 来 我 们 需要 告知 系统 ， 当 程序 局 动 的 时 候 应 该 初始 

化 MyApplication 类 ， 而 不 是 默认 的 Application 类 。 这 一 步 也 很 简单 ， 
在 AndroidManifest. xml 文 件 的 <application> 标 签 下 进行 指定 就 可 以 了 ， 
代码 如 下 所 示 : 


<manifest xmlns:android="http: eens android.com/apk/res/android" 
package="com. example. networkte 
android:versionCode="1" 
android:versionName="1.0" > 
<application 
android:name="com.example.networktest .MyApplication" 
i 


</application> 
</manifest> 


注意 这 里 在 指 4400 定 要 加 上 完整 的 包 名 ， 不 然 系 
统 将 无 法 找到 这 个 


这 样 我 们 就 已 经 实现 了 一 种 全 局 获取 context 的 机 制 ， 之 后 不 管 你 想 在 
项 目的 任何 地 方 使 用 context， 只 需要 调用 一 
FMyApplication.getcontext( ) 就 可 以 了 。 


么 接 下 来 我 们 再 对 sendHttpRequest() 方 法 进行 优化 ， 代 码 如 下 所 示 : 


public aE void sendHttpRequest(final String address, final HttpCallbackListener 
liste 
A NStor av lc) 
Toast.makeText (MyApplication.getContext(), "network is unavailable" 
Toast .LENGTH_SHORT). show( ); 


return; 


可 以 看 到 ，sendHttpRequest() 方 法 不 需要 再 通过 传 参 的 方式 来 得 
到 context 对 象 ， 而 是 调用 一 下 MyAppLication.getcontext() 方 法 就 可 以 
了 。 有 了 这 个 技巧 ， 你 再 也 不 用 为 得 不 到 context 对 象 而 发 悉 了 。 


然后 我 们 再 回顾 一 下 6.5.2 小 节 学 过 的 内 容 ， 当 时 为 了 让 LitePal 可 以 正常 
工作 ， 要 求 必须 在 AndroidManifest.xml 中 配置 如 下 内 容 : 


<application 
android:name="org.1litepal.LitePalApplication" 
De 





</application> 





其 实 道理 也 是 一 样 的 ， 因 为 经 过 这 样 的 配置 之 后 ，LitePal 就 能 在 内 部 目 
动 获 取 到 Context 了 。 


不 过 这 里 你 可 能 义 会 产生 疑问 ， 如 果 我 们 已 经 配置 过 了 自己 的 
Application 怎 么 办 ? 这 样 岂 不 是 和 LitepPalApplication 冲 突 了 ? 没 错 ， 
任何 一 个 项 目 都 只 能 配置 一 个 Application， 对 于 这 种 情况 ，LitePal 提 供 
了 很 简单 的 解决 方案 ， 那 就 是 在 我 们 自己 的 Application 中 去 调用 LitePal 
的 初始 化 方法 就 可 以 了 ， 如 下 所 示 : 


public class MyApplication extends Application { 





private static Context context; 
@override 
public void onCreate() { 


context = getApplicationContext(); 
LitePal.initialize(context); 


public static Context getContext() { 
return context,; 


} 


使 用 这 种 写法 ， 就 相当 于 我 们 把 全 局 的 context 对 象 通 过 参数 传递 给 了 
LitePal， 效 果 和 在 AndroidManifest.xml 中 配置 LitePalApplication 是 一 
模 一 样 的 。 


13.2 ”使 用 Intent 传 递 对 象 


Intent 的 用 法 相信 你 已 经 比较 熟悉 了 ， 我 们 可 以 借助 它 来 局 动 活动 、 发 
送 广播 、 局 动 服 务 等。 在 进行 上 述 操作 的 时 候 ， 我 们 还 可 以 在 Intent 中 
以 达到 传 值 的 效果 ， 比 如 在 FirstActivity 中 添加 
0 下 代码 : 





这 里 调用 了 Intent 的 putExtra() 方 法 来 添加 要 传递 的 数据 ， 之 后 
在 SecondActivity 中 就 可 以 得 到 这 些 值 了 ， 代 码 如 下 所 示 : 


getIntent().getStringExtr a( "S 2 ing- ata"); 
getIn te nt().getIntExtra("int_data", 0 


但 是 不 知道 你 有 没有 发 现 ，putExtra() 方 法 中 所 支持 的 数据 类 型 是 有 限 
的 ， 昌 然 常 用 的 一 些 数据 类 型 它 都 会 支持 ， 但 是 当 你 想 去 传递 一 些 自 定 
义 对 象 的 时 候 ， 束 会 有 发 现 无 从 下 手 。 不 用 担心 ， 下 面 我 们 束 学 习 一 下 使 
用 Intent 来 传递 对 象 的 技巧 。 


13.2.1 Serializable 方 式 
使 用 Intent 来 传递 对 象 通 常 有 两 种 实现 方式 : Serializable 和 Parcelable， 
本 小 节 中 我 们 先 来 学 习 一 下 第 一 种 实现 方式 。 


Serializable 是 序列 化 的 意思 ， 表 示 将 一 个 对 象 转换 成 可 存储 或 可 传输 的 
状态 。 序列 化 后 的 对 象 可 以 在 网 络 上 进行 传输 ， 也 可 以 存储 到 本 地 。 至 
于 序列 化 的 方法 也 很 简单 ， 只 需要 让 一 个 类 去 实现 serializable 这 个 接 
口 束 可 以 了 。 


比如 说 有 一 个 Person 类 ， 其 中 包含 了 name 和 age 这 两 个 字段 ， 想 要 将 它 
序列 化 就 可 以 这 样 写 : 


public class Person implements Serializablef{ 








private String name; 


private int age; 


public String getName() { 
return name 


} 

public void setName(String name) { 
this.name = name; 

. 

public int getAge() { 
return age; 

} 

public void setAge(int age) { 
this.age = age; 

} 


其 中 ，get、set 方 法 都 是 用 于 赋值 和 读 取 字段 数据 的 ， 最 重要 的 部 分 是 
在 第 一 行 。 这 里 让 person 类 去 实现 了 serializable 接 口 ， 这 样 所 有 的 
Person 对 象 就 都 是 可 序列 化 的 了 。 


接 下 来 在 FirstActivity 中 的 写法 非常 简单 : 





son person = new Person(); 
0 nm 


Pear 

person.setName("Tom"); 

person.setAge(20); 

Intent intent new Intent(FirstActivity.this, SecondActivity.class); 
intent.putExtra("person_data", person); 

startActivity(intent); 


可 以 看 到 ， 这 里 我 们 创建 了 一 个 Person 的 实例 ， 然 后 就 直接 将 它 传 入 
到 putExtra() 方 法 中 了 。 由 于 Person 类 实现 了 serializable 接 口 ， 所 以 
才 可 以 这 样 写 。 

接 下 来 在 secondActivity 中 获取 这 个 对 象 也 很 简单 ， 写 法 如 下 : 


Person person = (Person) getIntent().getSerializableExtra("person_data"); 


这 里 调用 J getSerializableExt ral ) 方 法 来 获取 通过 参数 传递 过 来 的 序 
列 化 对 象 ， 接 着 再 将 它 癌 下 转型 成 Pearson 对 象 ， 这 样 我 们 就 成 功 实 现 了 
使 用 Intent 来 传递 对 象 的 功能 


13.2.2 ”Parcelable 方 式 
除了 Serializable 之 外 ， 使 用 Parcelable 也 可 以 实现 相同 的 效果 ， 不 过 不 同 


于 将 对 象 进 行 序列 化 ，Parcelable 方 式 的 实现 原理 是 将 一 个 完整 的 对 象 进 
行 分 解 ， 而 分 解 后 的 每 一 部 分 都 是 Intent 所 支持 的 数据 类 型 ， 这 样 也 就 





实现 传递 对 象 的 功能 了 。 


下 面 我 们 来 看 一 下 Parcelable 的 实现 方式 ， 修 改 Person 中 的 代码 ， 如 下 所 
仆 : 


public class Person implements Parcelable { 
private String name; 


private int age; 


@Override 

public int describeContents() { 
return 0; 

;} 

@override 

public void writeToParcel(Parcel dest, int flags) { 
dest.writestring(name); // 写 出 name 
dest.writeInt(age); // 写 出 age 

省 


public static final Parcelable.Creator<Person> CREATOR = new Parcelable. 
Creator<Person>() { 


@override 

public Person createFromParcel(Parcel source) { 
Person person = new Person(); 
person.name = source.readstring(); // 读 取 name 
person.age = source.readInt(); // 读 取 age 
return person; 


} 


@override 
public Person[] newArray(int size) { 
return new Person[sizel]; 
} 
}; 


Parcelable 的 实现 方式 要 稍微 复杂 一 些 。 可 以 看 到 ， 首 先 我 们 让 Person 类 
去 实现 了 Parcelable 接 口 ， 这 样 就 必须 重 写 describecontents() 和 
writeToParcel() 这 两 个 方法 。 其 中 describecontents() 方 法 直接 返回 0 
就 可 以 了 ， 而 writeToParcel() 方 法 中 我 们 需要 调用 Parcel 的 writexxx() 
方法 ， 将 Person 类 中 的 字段 一 一 写 出 。 注 意 ， 字 符 串 型 数据 就 调 

用 writestring() 方 法 ， 整 型 数据 就 调用 writeInt() 方 法 ， 以 此 类 推 


除 此 之 外 ， 我 们 还 必须 在 Person 类 中 提供 一 个 名 为 cREATOR 的 常量 ， 这 
里 创建 了 Parcelable.Ccreator 接 口 的 一 个 实现 ， 并 将 泛 型 指定 

为 Person。 接着 需要 重 写 createFromParcel( ) 和 mnewArray( ) 这 两 个 方 

法 ， 在 createFromParcel() 方 法 中 我 们 要 去 读 取 刚才 写 出 的 name 和 age 字 
段 ， 并 创建 一 个 person 对 象 进 行 返回 ， 其 中 name 和 age 都 是 调用 Parcel 的 
readXxxx() 方 法 读 取 到 的 ， 注 意 这 里 读 取 的 顺序 一 定 要 和 刚才 写 出 的 顺 
序 完 全 相同 。 而 newArray() 方 法 中 的 实现 就 简单 多 了 ， 只 需要 new 出 一 
个 Person 数 组 ， 并 使 用 方法 中 传 入 的 size 作 为 数组 大 小 就 可 以 了 。 








接 下 来 ， 在 FirstActivity 中 我 们 仍然 可 以 使 用 相同 的 代码 来 传递 Person 
对 象 ， 只 不 过 在 secondActivity 中 获取 对 象 的 时 候 需 要 稍 加 改动 ， 如 下 
有 所 示 : 


Person person = (Person) getIntent().getParcelableExtra("person_data"); 


注意 ， 这 里 不 再 是 调用 getserializableExtra( ) 方 法 ， 而 是 调 
用 getParcelableExtra( ) 方 法 来 获取 传递 过 来 的 对 象 了 ， 其 他 的 地 方 都 
完全 相同 。 


这 样 我 们 束 把 使 用 Intent 来 传递 对 象 的 两 种 实现 方式 都 学 习 完 了 ， 对 比 
一 下 ，Serializable 的 方式 较为 简单 ， 但 由 于 会 把 整个 对 象 进行 序列 化 ， 
因此 效率 会 比 Parcelable 方 式 低 一 些 ， 所 以 在 通常 情况 下 还 是 更 加 推荐 使 
用 Parcelable 的 方式 来 实现 Intent 传 递 对 象 的 功能 。 





13.3 ”定制 自己 的 日 志 工 具 


早 在 第 1 章 的 1.4 世 中 我 们 就 已 经 学 过 了 Android 日 志 工 具 的 用 法 ， 并 且 日 
志 工 具 也 确实 贯穿 了 我 们 整 本 书 的 学 习 ， 基 本 上 每 一 章 都 有 用 到 过 。 虽 
然 Android 中 目 带 的 日 志 工 具 功 能 非常 强大 ， 但 也 不 能 说 是 完全 没有 缺 
点 ， 例 如 在 打印 日 志 的 控制 方面 就 做 得 不 够 好 。 


打 个 比方 ， 你 正在 编写 一 个 比较 庞大 的 项 目 ， 期 间 为 了 方便 调试 ， 在 代 
码 的 很 多 地 方 都 打印 了 大 量 的 日 志 。 最 近 项 目 已 经 基本 完成 了 ， 但 是 却 
有 一 个 非常 让 人 头疼 的 问题 ， 之 前 用 于 调试 的 那些 日 志 ， 在 项 目 正式 上 
线 之 后 仍然 会 照 币 打印 ， 这 样 不 仅 会 降低 程序 的 运行 效率 ， 还 有 可 能 将 
一 些 机 密 性 的 数据 泄露 出 去 。 


那 该 怎么 办 呢 ? 难道 要 一 行 一 行 地 把 所 有 打印 日 志 的 代码 都 删 掉 ? 显然 
这 不 是 什么 好 扣子， 不 仅 费 时 费力 ， 而 且 以 后 你 继续 维护 这 个 项 目的 时 
候 可 能 还 会 需要 这 些 日 志 。 因 此 ， 最 理想 的 情况 是 能 够 自由 地 控制 日 志 
的 打印 ， 当 程序 处 于 开发 阶段 时 就 让 日 志 打 印 出 来 ， 当 程序 上 线 了 之 后 
就 把 日 志 屏 贡 掉 。 


看 起 来 好 像 是 挺 高 级 的 一 个 功能 ， 其 实 并 不 复杂 ， 我 们 只 需要 定制 一 个 
自己 的 日 志 工 具 束 可 以 轻松 完成 了 。 比 如 新 建 一 个 Logutil 类 ， 代 码 如 
Ma: 


public class LogUtil { 






































public static final int VERBOSE = 1; 


final 
publi tat final int DEBUG = 2; 
publi tatic final int INFO = 3; 
publi tatic final int WARN = 4; 
publi tatic final int ERROR = 5; 
publi tat final int NOTHING = 6; 
leve 


public static int 1 = VERBOSE; 





public static void v(String tag, String msg) { 
if (level <= VERBOSE) { 
Log.v(tag, msg); 


public static void d(String tag, String msg) { 
i { 


public static void i(String tag, String msg) { 
if (level <= INFO) { 
g.i(tag, msg); 


可 以 看 到 ， 我 们 在 Logutil 中 先是 定义 了 
VERBOSE、DEBUG、INFO0、WARN、ERROR、NOTHING 这 6 个 整 型 常量 ， 并 日 它 
们 对 应 的 值 都 是 递增 的 。 然 后 又 定义 了 一 个 静态 变量 level， 可 以 将 它 
的 值 指 定 为 上 面 6 个 常量 中 的 任意 一 个 。 


接 下 来 我 们 提供 了 v()、d()、i()、w()、e() 这 5 个 自 定义 的 日 志方 法 ， 
在 其 内 部 分 别 调用 了 Log.v()、Log.d()、Log.i()、Log.w()、Log.e() 这 
5 个 方法 来 打印 日 志 ， 只 不 过 在 这 些 自 定义 的 方法 中 我 们 都 加 入 了 一 
个 if 判 断 ， 只 有 当 1level 的 值 小 于 或 等 于 对 应 日 志 级 别 值 的 时 候 ， 才 会 
将 日 志 打 印 出 来 。 


这 样 就 把 一 个 自 定 义 的 日 志 工 具 创 建 好 了 ， 之 后 在 项 目 里 我 们 可 以 像 使 
普通 的 日 志 工具 一 样 使 用 Logutil， 比 如 打印 一 行 DEBUG 级 别 的 日 志 
就 可 以 这 样 写 : 


LogUtil.d("TAG", "debug 10g"); 








打印 一 行 WARN 级 别 的 日 志 就 可 以 这 样 写 : 


LogUtil.w("TAG", "warn 10g"); 


然后 我 们 只 需要 修改 level 变 量 的 值 ， 就 可 以 自由 地 控制 日 志 的 打印 行 
为 了 了 。 比 如 让 level 等 于 vERBO0SE 束 可 以 把 所 有 的 日 志 都 打印 出 来 ， 让 
level 等 于 WARN 碌 可 以 只 打印 敬告 以 上 级 别 的 日 志 ， 让 level 等 于 NOTHING 
就 可 以 把 所 有 日 志 都 屏蔽 掉 。 


使 用 了 这 种 方法 之 后 ， 刚 才 所 说 的 那个 问题 束 不 复 存 在 了 ， 你 只 需要 在 
开发 阶段 将 level 指 定 成 VERBOSE， 当 项 目 正式 上 线 的 时 候 将 level 指 定 
成 NOTHING 就 可 以 了 。 





13.4 调试 Android 程 序 


当 开 发 过 程 中 遇 到 一 些 奇怪 的 bug， 但 又 迟 迟 定位 不 出 来 原因 是 什么 的 
时 候 ， 最 好 的 解决 办 法 就 是 调试 了 。 调 试 允许 我 们 逐 行 地 执行 代码 ， 并 
可 以 实时 观察 内 存 中 的 数据 ， 从 而 能 够 比较 轻易 地 查 出 问题 的 原因 。 那 
么 本 节 中 我 们 就 来 学 习 一 下 使 用 Android Studio 来 调试 Android 程 序 的 技 
Ls 


还 记得 在 第 5 章 的 最 佳 实践 环节 中 编写 的 那个 强制 下 线程 序 吗 ? 就 让 我 
们 通过 这 个 例子 来 学 习 一 下 Android 程 序 的 调试 方法 吧 。 这 个 程序 中 有 
一 个 登录 功能 ， 比 如 说 现在 登录 出 现 了 问题 ， 我 们 就 可 以 通过 调试 来 定 
位 问题 的 原因 。 


不 用 多 说 ， 调 试 工作 的 第 一 步 肯 定 是 添加 断 点 ， 这 里 由 于 我 们 要 调试 登 
录 部 分 的 问题 ， 所 以 断 点 可 以 加 在 登录 按钮 的 点 击 事 件 里 面 。 添 加 了 断 点 
的 方法 也 很 简单 ， 只 需要 在 相应 代码 行 的 左边 点 击 一 下 就 可 以 了 ， 如 图 
13.1 所 示 。 

















Login = (Button) findViewById(R. id. login); 
login.setOnClickListener(new View.OnClickListener() { 


@Override 
el public void onClick(View v) { 
wy String account = accountEdit.getText().toString(); 


String password = passwordEdit.getText().toString(); 
图 13.1 添加 断 点 
如 果 想 要 取消 这 个 断 点 ， 对 着 它 再 次 点 击 就 可 以 了 。 
添加 好 了 汤 点 ， 接 下 来 就 可 以 对 程序 进行 调试 了 ， 点 击 Android Studio 顶 


部 工具 栏 中 的 Debug 按 钮 (图 13.2 中 最 右边 的 按钮 )， 就 会 使 用 调试 模 
式 来 局 动 程序 。 














I[&app7™| 了 其 


图 13.2 调试 按钮 


等 到 程序 运行 起 来 的 时 候 ， 首 移 会 看 到 一 个 提示 框 ， 如 图 13.3 所 示 。 
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Waiting For Debugger 


Application 

BroadcastBestPractice (process 
com.example.broadcastbestpractice) is 
waiting for the debugger to attach. 


FORCE CLOSE 





图 13.3” 等待 调试 器 提示 框 


这 个 框 很 快 就 会 自动 消失 ， 然 后 在 输入 框 里 输入 账号 和 密码 ， 并 点 击 
Login 按 钮 ， 这 时 Android 。” Studio 就 会 自动 打开 Debug 和 窗口 ， 如 图 13.4 所 
外。 





overrlide 
protected void onCreatelBundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R, layout ,activity login); 
accountEdit = (EditText) findViewById(R, id,account); 
passwordEdit = (EditText) findViewById(R. id, password); 


| um 




















Login = (Button) findyiewById(R. id, login); | 
login, setOnClickListener(new View,0nCUickListener{) { 
Override 
时 blic Wed onClick(View v) { v: "anidroidl， p ort, V7 ,widget,AppCompatButton{ie9a5ld VFED,,C,. ...P,... 0,360-1688,548 
S Str account accountEdit,oetText(),toString(); 
| String password = passwordEdit. getText()。 tost rno(); 
if (account,equals("admin") &6 password, equals("123456")) { | 
Intent intent = new Intent(LoginActivity, this, MainActivity, cl8ss); 
StartActivity(intent); 
finish(); 
} else { 
Toast,mokeText (LoginActivity, this, "account or password is invalid", 
j Toast ,LENGTH_SHORT) ,5how{); 
} 
)); 
} 
Debug app 次 志 
及 Debugger | 国 consoe *' 隔 王 兰 关 玉 向 站 国 闽 中 
| 局 pames + 加 Variables + 
中 


总 个 志平 | Sths = {LoginActivitys1@4318) 

* v= IAppCompatBunon@4320} "android.supporLy7.widgetAppCompatButtonfle9a5 View 
> WirpasswordEdit = {AppCompatEdiTextD4324) "androld,Supportv7.widgetAppComp ， View 
>» accountEdit = {AppCompatEdiiText94325j "androld.supporLv7.wWidgeLAppCompat ，View 


马 ne group "main":… 








象 0 MitvS om,.example.broadcasthbestpr 
S performclickd: 5204， View (android,view) 

run0:21153, View$PerformClick (android. view) 
Le handleCallback0:739, Handier (android.0s) 
一 
党 





dispatchMessage0:95, Handler (android,0s) 
Joop0:148, Looper (android.o0s) 
| main0:5417, ActvityThread (android,app) 
信 | invoke0;-1, Method (java,lang.reflecd 
2 run0:726, Zygoteinit$ MethodAndArgsCaller {com.android.int 











图 13.4 ” Debug 窗口 


接 下 来 每 按 一 次 F8 健 ， 人 代码 就 会 问 下 执行 一 行 ， 并 且 通 过 Variables 视 图 
还 可 以 看 到 内 存 中 的 数据 ， 如 图 13.5 所 示 。 












室 this = {LoginActivity$ 1@4318} 
去 v = {AppCompatButton@4320} "android.support.v7.widget.AppCompatButton{ le9a'... View 
宇 account = "abc" 

吾 password = "123" 


Vv vy vv 








图 13.5 Variables 视 图 


可 以 看 到 ， 我 们 从 输入 框 里 获取 到 的 账号 密码 分 别 是 abc 和 123， 而 程序 
里 要 求 正确 的 账号 密码 是 admin 和 123456， 所 以 登录 才 会 出 现 问题 。 这 
样 我 们 就 通过 调试 的 方式 轻松 地 把 问题 定位 出 来 了 ， 调 试 完成 之 后 点 击 
Debug 窗 口中 的 Stop 按 钮 (图 13.6 中 最 下 边 的 按钮 ) 来 结束 调试 即 可 。 








> 
加 
图 13.6 ”结束 调试 按钮 


这 种 调试 方式 虽然 完全 可 以 正常 工作 ， 但 在 调试 模式 下 ， 程 序 的 运行 效 
率 将 会 大 大 地 降低 ， 如 果 你 的 断 点 加 在 一 个 比较 靠 后 的 位 置 ， 需 要 执行 
很 多 的 操作 才能 运行 到 这 个 断 点 ， 那 么 前 面 这 些 操作 就 都 会 有 一 些 卡 顿 
的 感觉 。 没 关系 ，Android 还 提供 了 男 外 一 种 调试 的 方式 ， 可 以 让 程序 
随时 进入 到 调试 模式 ， 下 面 我 们 就 来 答 试 一 下 。 


这 次 不 需要 选择 调试 模式 来 启动 程序 了 ， 束 使 用 正常 的 方式 来 启动 程 
序 。 由 于 现在 不 是 在 调试 模式 下 ， 程 序 的 运行 速度 比较 快 ， 可 以 先 把 账 
号 和 密码 输入 好 。 然 后 点 击 Android Studio 顶 部 工具 栏 的 Attach debugger 
to Android process 按 钮 (图 13.7 中 最 左边 的 按钮 〉。 








FP 委 (各 
图 13.7 动态 调试 按钮 
此 时 会 弹出 一 个 进程 选择 提示 框 ， 如 图 13.8 所 示 。 





Select a process to attach to: 


[LL] Show all processes 





Debugger: | Auto 阅 
v [Emulator Nexus 5X API 24 Android 了 





com.example.broadcastbestpractice 








图 13.8 ”进程 选择 提示 框 


这 里 目前 只 列 出 了 一 个 进程 ， 也 就 是 我 们 当前 程序 的 进程 。 选 中 这 个 进 
程 ， 然 后 点 击 OK 按 钮 ， 就 会 让 这 个 进程 进入 到 调试 模式 了 。 





接 下 来 在 程序 中 点 击 Login 按 钮 ，Android Studio 同 样 也 会 自动 打开 
Debug 窗 口 ， 之 后 的 流程 就 都 是 相同 的 了 。 相 比 起 来 ， 第 二 种 调试 方式 
会 比 第 一 种 更 加 灵活 ， 也 更 加 常用 。 


13.5 ”创建 定时 任务 


Android 中 的 定时 任务 一 般 有 两 种 实现 方式 ， 一 种 是 使 用 Java API 里 提供 
的 Timer 类 ， 一 种 是 使 用 Android 的 Alarm 机 制 。 这 两 种 方式 在 多 数 情况 
下 都 能 实现 类 似 的 效果 ， 但 Timer 有 一 个 明显 的 短 板 ， 它 并 不 太 适 用 于 
那些 需要 长 期 在 后 台 运 行 的 定时 任务 。 我 们 都 知道 ， 为 了 能 让 电池 更 加 
耐用 ， 每 种 手机 都 会 有 自己 的 休眠 策略 ，Android 手 机 就 会 在 长 时 间 不 
操作 的 情况 下 自动 让 CPU 进入 到 睡眠 状态 ， 这 就 有 可 能 导致 Timer 中 的 
定时 任务 无 法 正常 运行 。 而 Alarm 则 具有 唤醒 CPU 的 功能 ， 它 可 以 保证 
在 大 多 数 情况 下 需要 执行 定时 任务 的 时 候 CPU 都 能 正常 工作 。 需 要 注 
意 ， 这 里 唤醒 CPU 和 唤醒 屏幕 完全 不 是 一 个 概念 ， 二 万 不 要 产生 混 消 。 


13.5.1 Alarm 机 制 
那么 首先 我 们 来 看 一 下 Alarm 机 制 的 用 法 吧 ， 其 实 并 不 复杂 ， 主 要 就 是 


借助 了 AlarmManager 类 来 实现 的 。 这 个 类 和 NotificationManager 有 点 类 
似 ， 都 是 通过 调用 Context 的 getsystemService( ) 方 法 来 获取 实例 的 ， 只 
是 这 里 需要 传 入 的 参数 是 context .ALARM_SERVICE。 因 此 ， 获 取 一 

个 AlarmManager 的 实例 就 可 以 写成 : 


AlarmManager manager = (AlarmManager) getSystemService(Context .ALARM SERVICE); 




















接 下 来 调用 AlarmManager 的 set() 方 法 就 可 以 设置 一 个 定时 任务 了 ， 比 如 
说 想 要 设 定 一 个 任务 在 10 秒 钟 后 执行 ， 就 可 以 写成 : 


long triggerAtTime = SystemClock.elapsedRealtime() + 10 * 1000; 
manager .set (AlarmManager .ELAPSED_ REALTIME_ WAKEUP, triggerAtTime, pendingIntent); 





上 面 的 两 行 代码 你 不 一 定 能 看 得 明白 ， 因 为 set() 方 法 中 需要 传 入 的 3 个 
参数 稍微 有 点 复杂 ， 下 面 我 们 束 来 仔细 地 分 析 一 下 。 第 一 个 参数 是 一 个 
整 型 参数 ， 用 于 指定 AlarmManager 的 工作 类 型 ， 有 4 种 值 可 选 ， 分 别 
是 ELAPSED_REALTIME、 ELAPSED_REALTIME_WAKEUP、RTC 和 RTC_WAKEUP。 其 
中 ELAPSED_REALTIME 表 示 让 定时 任务 的 触发 时 间 从 系统 开机 开始 算 起 ， 
但 不 会 唤醒 CPU。ELAPSED_REALTIME_WAKEUP 同 样 表示 让 定时 任务 的 触发 





时 间 从 系统 开机 开始 算 起 ， 但 会 唤醒 CPU。RTc 表 示 让 定时 任务 的 触发 
时 间 从 1970 年 1 月 1 日 0 点 开始 算 起 ， 但 不 会 唤醒 CPU。RTC_wAKEUP 同 样 
表示 让 定时 任务 的 触发 时 间 从 1970 年 1 月 1 日 0 点 开始 算 起 ， 但 会 唤醒 
CPU。 使 用 Systemclock.elapsedRealtime() 方 法 可 以 获取 到 系统 开机 至 
今 所 经 历时 间 的 坚 秒 数 ， 使 用 System.currentTimeMillis() 方 法 可 以 获 
取 到 1970 年 1 月 1 日 0 点 至 今 所 经 历时 间 的 宣 秒 数 。 


然后 看 一 下 第 二 个 参数 ， 这 个 参数 就 好 理解 多 了 ， 就 是 定时 任务 触发 的 
时 间 ， 以 晤 秒 为 单位 。 如 果 第 一 个 参数 使 用 的 是 ELAPSED_REALTIME 

或 ELAPSED_REALTIME_WAKEUP， 则 这 里 传 入 开机 至 今 的 时 间 再 加 上 延迟 执 
行 的 时 间 。 如 果 第 一 个 参数 使 用 的 是 RTc 或 RTC_wWAKEUP， 则 这 里 传 入 
1970 年 1 月 1 日 0 点 至 今 的 时 间 再 加 上 延迟 执行 的 时 间 。 


第 三 个 参数 是 一 个 PendingIntent， 对 于 它 你 应 该 已 经 不 会 陌生 了 吧 。 
这 里 我 们 一 般 会 调用 getservice() 方 法 或 者 getBroadcast () 方 法 来 获取 
一 个 能 够 执行 服务 或 广播 的 PendingIntent。 这 样 当 定时 任务 被 触发 的 
时 候 ， 服 务 的 onstartcommand() 方 法 或 广播 接收 器 的 onReceive() 方 法 就 
可 以 得 到 执行 。 

了 解 了 set() 方 法 的 每 个 参数 之 后 ， 你 应 该 能 想到 ， 设 定 一 个 任务 在 10 
秒 钟 后 执行 也 可 以 写成 : 


long triggerAtTime = System.currentTimeMillis() + 10 * 
manager .set (AlarmManager .RTC_WAKEUP, triggerAtTime, pond Te 

















那么 ， 如 果 我 们 要 实现 一 个 长 时 间 在 后 侣 定时 运行 的 服务 该 怎么 做 呢 ? 
其 实 很 简单 ， 首 先 新 建 一 个 普通 的 服务 ， 比 如 把 它 起 名 叫 
LongRunningService， 然后 将 触发 定时 任务 的 代码 写 

至 Jonstartcommand() 方 法 中 ， 如 下 所 示 : 


public class LongRunningService extends Service { 


@override 
public IBinder onBind(Intent intent) { 
return null; 


} 


@Ooverride 
public int onStartCommand(Intent intent, int flags, int startId) { 
new Thread(new Runnable() { 
@Ooverride 
public void run 


所 .下 
// 在 这 里 执行 具体 的 逻辑 操作 


} 
下 二 SF 
AlarmManager manager = (AlarmManager ) getSystemService(ALARM_ SERVICE); 
int anHour = 60 * 69 * 1000; // 这 是 一 小 时 的 毫秒 数 
long triggerAtTime = SystemClock.elapsedRealtime() + anHour; 
Intent i = new Intent(this, LongRunningService.class); 
PendingIntent pi = PendingIntent.getService(this, 0, i, 0 
manager.set (AlarmManager .ELAPSED_REALTIME_WAKEUP, trigyerAtTime, ek 办 加 


return super.onStartCommand(intent, flags, startId); 
} 
} 


可 以 看 到 ， 我 们 先是 在 onstartcommand() 方 法 中 开局 了 一 个 子 线程 ， 这 
样 就 可 以 在 这 里 执行 具体 的 逻辑 操作 了 。 之 所 以 要 在 子 线程 里 执行 逻辑 
操作 ， 是 因为 逻辑 操作 也 是 需要 耗 时 的 ， 如 果 放 在 主线 程 里 执行 可 能 会 
对 定时 任务 的 准确 性 造成 轻微 的 影响 。 


创建 线程 之 后 的 代码 就 是 我 们 刚刚 讲解 的 Alarm 机 制 的 用 法 了 ， 先 是 获 
取 到 了 AlarmManager 的 实例 ， 然 后 定义 任务 的 触发 时 间 为 一 小 时 后 ， 再 
使 用 PendingIntent 指 定 处 理 定时 任务 的 服务 为 LongRunningService， 最 后 
调用 set() 方 法 完成 设 定 。 


这 样 我 们 就 将 一 个 长 时 间 在 后 台 定 时 运行 的 服务 成 功 实 现 了 。 因 为 一 旦 
启动 了 LongRunningService， 就 会 在 onstartcommand() 方 法 里 设 定 一 个 
定时 任务 ， 这 样 一 小 时 后 将 会 再 次 启动 LongRunningService， 从 而 也 就 
形成 了 一 个 永久 的 循环 ， 保 证 LongRunningService 的 onstartCommand( ) 
方法 可 以 每 隔 一 小 时 就 执行 一 次 。 


最 后 ， 只 需要 在 你 想 要 启动 定时 服务 的 时 候 调 用 如 下 代码 即 可 : 





Intent intent = new Intent(context, LongRunningService.class); 
context.startService(intent); 





另外 需要 注意 的 是 ， 从 Android 4.4 系 统 开 始 ，Alarm 任 务 的 触发 时 间 将 
会 变 得 不 准确 ， 有 可 能 会 延迟 一 段 时 间 后 任务 才能 得 到 执行 。 这 并 不 是 
个 bug， 而 是 系统 在 耗 电 性 方面 进行 的 优化 。 系 统 会 目 动 检测 目前 有 多 
少 Alarm 任 务 存 在 ， 然 后 将 触发 时 间 相 近 的 几 个 任务 放 在 一 起 执行 ， 这 
就 可 以 大 幅度 地 减少 CPU 被 唤醒 的 次 数 ， 从 而 有 效 延 长 电池 的 使 用 时 
间 。 


当然 ， 如 果 你 要 求 Alarm 任 务 的 执行 时 间 必 须 准 确 无 误 ，Android 仍 然 提 
供 了 解决 方案 。 使 用 AlarmManager 的 setExact() 方 法 来 蔡 代 set () 方 

法 ， 就 基本 上 可 以 保证 任务 能 够 准时 执行 了 。 

13.5.2 Doze 模式 


虽然 Android 的 每 个 系统 版 本 都 在 手机 电量 方面 努力 进行 优化 ， 不 过 一 


直 没 能 解决 后 台 服 务 泛 小、 手机 电量 消耗 过 快 的 问题 。 于 是 在 Android 
6.0 系 统 中 ， 谷 歌 加 入 了 一 个 全 新 的 Doze 模 式 ， 从 而 可 以 极 大 幅度 地 延 
长 电池 的 使 用 寿命 。 本 小 节 中 我 们 就 来 了 解 一 下 这 个 模式 ， 并 且 掌 握 一 
些 编程 时 的 注意 事项 。 


首先 看 一 下 到 底 什么 是 Doze 模 式 。 当 用 户 的 设备 是 Android 6.0 或 以 上 系 
统 时 ， 如 果 该 设备 未 插 接 电源 ， 处 于 静止 状态 (Android 7.0 中 删除 了 这 
一 和 条件) ， 且 屏幕 关闭 了 一 段 时 间 之 后 ， 就 会 进入 到 Doze 模 式 。 在 
Doze 模 式 下 ， 系 统 会 对 CPU 、 网 络 、Alarm 等 活动 进行 限制 ， 从 而 延长 
了 电池 的 使 用 寿命 。 


当然 ， 系 统 并 不 会 一 直人 处 于 Doze 模 式 ， 而 是 会 间 握 性 地 退出 Doze 模 式 
一 小 段 时 间 ， 在 这 段 时 间 中 ， 应 用 就 可 以 去 完成 它们 的 同步 操作 、 
Alarm 人 任务， 等 等 。 图 13.9 完 整 描 述 了 Doze 模 式 的 工作 过 程 。 








未 手电 源 短暂 退出 Doze 模 式 


Wm 


屏幕 关闭 
图 13.9” ”Doze 模式 的 工作 过 程 


可 以 看 到 ， 随 着 设备 进入 Doze 模 式 的 时 间 越 长 ， 间 鞭 性 地 退出 Doze 模 
式 的 时 间 间 隅 也 会 越 长 。 因 为 如 果 设 备 长 时 间 不 使 用 的 话 ， 是 没 必 要 频 
索 退 出 Doze 模 式 来 执行 同步 等 操作 的 ，Android 在 这 些 细节 上 的 把 控 使 
得 电池 寿命 进一步 得 到 了 延长 。 


接 下 来 我 们 具体 看 一 看 在 Doze 模 式 下 有 哪些 功能 会 受到 限制 吧 。 






Doze 模 式 














。 网 络 访问 修 茶 止 。 


。 系统 忽略 唤醒 CPU 或 者 屏幕 操作 。 

。 系统 不 再 执行 WIFI 扫描 。 

。 系统 不 再 执行 同步 服务 。 

。 Alarm 任 务 将 会 在 下 次 退出 Doze 模 式 的 时 候 执行 。 


注意 其 中 的 最 后 一 条 ， 也 就 是 说 ， 在 Doze 模 式 下 ， 我 们 的 Alarm 任 务 将 
会 变 得 不 和 准时。 当然， 这 在 大 多 数 情 况 下 都 是 合理 的 ， 因 为 只 有 当 用 户 
长 时 间 不 使 用 手机 的 时 候 才 会 进入 Doze 模 式 ， 通 销 在 这 种 情况 下 对 
Alarm 任 务 的 准时 性 要 求 并 没有 那么 高 。 


不 过 ， 如 果 你 真 的 有 非常 特殊 的 需求 ， 要 求 Alarm 任 务 即使 在 Doze 模 式 
下 也 必须 正和 执行 ，Android 还 是 提供 了 解决 方案 。 调 用 AlarmManager 
的 setAndAllowwhileIdle( ) 或 setExactAndAllowwhileIdle() 方 法 就 能 让 
定时 任务 即使 在 Doze 模 式 下 也 能 正常 执行 了 ， 这 两 个 方法 之 间 的 区 别 和 
set()、setExact() 方 法 之 则 的 区 别 是 一 样 的 。 








13.6 多 窗口 模式 编程 


由 于 手机 屏幕 大 小 的 限制 ， 传 统 情况 下 一 个 手机 上 只 能 同时 打开 一 个 应 用 
程序 ， 无 论 是 Android、iOS 还 是 Windows Phone 都 是 如 此 。 我 们 也 早 就 
对 此 习以为常 ， 认 为 这 是 理所当然 的 事情 。 而 Android 7.0 系 统 中 却 引入 
了 一 个 非常 有 特色 的 功能 多 窗口 模式 ， 它 允许 我 们 在 同一 个 屏幕 中 
同时 打开 两 个 应 用 程序 。 对 于 手机 屏幕 越 来 越 大 的 今天 ， 这 个 功能 确实 
是 越发 重要 了 ， 那 么 本 节 中 我 们 就 将 针对 这 一 主题 进行 学 习 。 


13.6.1 进入 多 窗口 模式 


首先 你 需要 知道 ， 我 们 不 用 编写 任何 额外 的 代码 来 让 应 用 程序 文 持 多 窗 
口 模式 。 事 实 上 ， 本 书 中 所 编写 的 所 有 项 目 都 是 文 持 多 窗口 模式 的 。 但 
征 这 并 不 意味 着 我 们 惑 不 需要 对 多 窗口 模式 进行 学 习 ， 因 为 系统 化 地 了 
解 这 些 知识 点 才能 编写 出 在 多 窗口 模式 下 兼容 性 更 好 的 程序 。 


那么 先 来 看 一 下 如 何 才能 进入 到 多 窗口 模式 。 手 机 的 导航 栏 你 肯定 是 再 
熟悉 不 过 了 ， 上 面 一 共有 3 个 按钮 ， 如 图 13.10 所 示 。 


图 13.10 手机 导航 栏 


其 中 左边 的 Back 按 钮 和 中 间 的 Home 按 钮 我 们 都 经 常 使 用 ， 但 是 右边 的 
Overview 按 钮 使 用 得 就 比较 少 了 。 这 个 按钮 的 作用 是 打开 一 个 最 近 访 问 
过 的 活动 或 任务 的 列表 界面 ， 从 而 能 够 方便 地 在 多 个 应 用 程序 之 间 进 行 
切换 ， 如 图 13.11 所 示 。 



































图 13.11 Overview 列表 界面 
我 们 可 以 通过 以 下 两 种 方式 进入 多 窗口 模式 。 
。 在 Overview 列 表 界 面 长 按 任 意 一 个 活动 的 标题 ， 将 该 活动 拖 动 到 屏 
幕 突出 显示 的 区 域 ， 则 可 以 进入 多 窗口 模式 。 
。 打开 任 意 一 个 程序 ， 长 按 Overview 按 钮 ， 也 可 以 进入 多 窗口 模式 。 
比如 说 我 们 首先 打开 了 MtaterialTest 程 序 ， 然 后 长 按 Overview 按 钮 ， 效 果 


如 图 13.12 所 示 。 





图 13.12 进入 多 窗口 模式 


可 以 看 到 ， 现 在 整个 屏幕 被 分 成 了 上 下 两 个 部 分 ，MaterialTest 程 序 占 气 
了 上 半 屏 ， 下 半 屏 仍然 还 是 一 个 Overview 列 表 界 面 ， 另 外 Overview 按 钮 
的 样式 也 有 了 变化 。 现 在 我 们 可 以 从 Overview 列 表 中 选择 任意 一 个 其 他 
程序 ， 比 如 说 这 里 点 击 LBSTest， 效 果 如 图 13.13 所 示 。 





Watermelon Strawberry 














~ 多 
国泰 新 村 要 
限 竣 也 sr 
5 小 学 Y 于 油 牙 [2 
ee 小 一 一 人 5 一 一 二 
部 苑 路 生路 局 必 山 湖 独 墅 项 南 
和 ~ 
"ee. 
党 吕 十 
200 米 2 
Ba 人 am eft 
ee | 
4 O 


图 13.13 ”同时 打开 两 个 程序 


我 们 还 可 以 将 模拟 器 旋转 至 水 平方 向 ， 这 样 上 下 分 屏 的 多 窗口 模式 会 自 
动 切换 成 左右 分 屏 的 多 窗口 模式 ， 如 图 13.14 所 示 。 


一 F LBSTest 





图 13.14 左右 分 屏 的 多 窗口 模式 


多 窗口 模式 的 用 法 大 概 就 是 这 个 样子 了 ， 我 们 可 以 将 任意 两 个 应 用 同时 
打开 ， 这 样 束 能 组 合 出 许多 更 为 丰富 的 使 用 场景 。 比 如 说 刷 微 博 的 同时 
还 能 时 刻 关 注 QQ 群 消息 ， 看 电影 的 同时 还 能 和 别人 一 直 聊 着 微 信 ， 等 

等 。 如 果 想 要 退出 多 窗口 模式 ， 只 需要 再 次 长 按 Overview 按 钮 ， 或 者 将 
屏幕 中 央 的 分 隔 线 同 屏幕 任意 一 个 方 癌 拖 动 到 底 即 可 。 


可 以 看 出 ， 在 多 窗口 模式 下 ， 整 个 应 用 的 界面 会 缩小 很 多 ， 那 么 编写 程 
序 时 就 应 该 多 考虑 使 用 match_parent 属 性 、RecyclerView、ListView、 
ScrollView 每 控件 ， 来 让 应 用 的 界面 能 够 更 好 地 适 配 各 种 不 同 尺寸 的 屏 
幕 ， 尺 量 不 要 出 现 屏 幕 尺寸 变化 过 大 时 界面 就 无 法 正常 显示 的 情况 。 


13.6.2 多 窗口 模式 下 的 生命 周期 

接 下 来 我 们 学 习 一 下 多 窗口 模式 下 的 生命 周期 。 其 实 多 窗口 模式 并 不 会 
改变 活动 原 有 的 生命 周期 ， 只 是 会 将 用 户 最 近 交 互 过 的 那个 活动 设置 为 
运行 状态 ， 而 将 多 窗口 模式 下 另外 一 个 可 见 的 活动 设置 为 暂停 状态 。 如 
果 这 时 用 户 又 去 和 暂停 的 活动 进行 交互 ， 那 么 该 活动 束 变 成 运行 状态 ， 



































之 前 处 于 运行 状态 的 活动 变 成 暂停 状态 。 


下 面 我 们 还 是 通过 一 个 例子 来 更 加 直观 地 理解 多 窗口 模式 下 活动 的 生命 
周期 。 首 先 打开 MaterialTest 项 目 ， 修 改 MainActivity 中 的 代码 ， 如 下 所 
未: 


public class MainActivity extends AppCompatActivity { 


private static final String TAG = "MaterialTest"; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
Log.d(TAG, "onCreate"); 


} 


@override 

protected void onStart() { 
super .onstart(); 
Log.d(TAG, "onSstart"); 


@override 

protected void onResume() { 
super .onResume( ); 
Log.d(TAG, "onResume"); 


@override 

protected void onPause() { 
super .onpPause(); 
Log.d(TAG, "onPause"); 


@Override 

protected void onStop() { 
super .onstop(); 
Log.d(TAG, "onSstop"); 


@override 

protected void onDestroy() { 
super .onDestroy(); 
Log.d(TAG, "onDestroy"); 


@override 

protected void onRestart() { 
super. onRestart( ); 
Log.d(TAG, "onRestart"); 


这 里 我 们 在 Activity 的 7 个 生命 周期 回调 方法 中 分 别 打 印 了 一 句 日 志 。 


然后 点 击 Android Studio 导 航 栏 上 的 File ;Open Recent-,LBSTest， 重 新 
打开 LBSTest 项 目 。 修 改 MainActivity 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private static final String TAG = "LBSTest"; 


@override 

protected void onCreate(Bundle SavedInstanceState) { 
super .onCreate(savedInstanceState); 
Log.d(TAG, "onCreate"); 


@override 

protected void onStart() { 
Super .onstart(); 
Log.d(TAG, "onstart"); 


@Override 

protected void onResume() { 
super .onResume( ); 
Log.d(TAG, "onResume"); 
mapView.onResume( ); 


@Override 

protected void onPause() { 
super .onPause(); 
Log.d(TAG, "onPpause"); 
mapView.onPause(); 


@Override 
protected void onStop() { 
ur onstop( ); 
d(TAG, "onstop"); 


@Override 
protected void onDestroy() { 
super .onDestroy(); 
Log.d(TAG, "onDestroy"); 
mLocationClient.stop(); 
mapView.onDestroy(); 
baiduMap.setMyLocationEnabled(false); 
} 


@Override 

protected void onRestart() { 
super .onRestart(); 
Log.d(TAG, "onRestart"); 


这 里 同样 也 是 在 Activity 的 7 个 生 合 8 周期 回调 方法 中 分 别 打 印 了 一 句 日 
志 。 注 意 这 两 处 日 志 的 TAG 是 不 一 样 的 ， 方 便 我 们 进行 区 分 。 


现在 ， ds de 目的 最 新 代码 都 运行 到 模拟 


器 上 ， 然 后 启动 MaterialTest 程 序 。 这 时 观察 logcat 中 的 打印 日 志 《〈 注 意 
， 二 滤器 选择 为 No Filters) ， 如 图 13.15 所 示 。 
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com. example. materialtest D/MaterialTest: onCreate 








com. example. materialtest D/MaterialTest: onStart 


com. example. materialtest D/MaterialTest: onResume 


图 13.15 启动 MaterialTest 时 的 打印 日 志 


可 以 看 到 ，oncreate()、onstart() 和 onResume() 方 法 会 依次 得 到 执行 ， 
这 个 也 是 在 我 们 意料 之 中 的 。 然 后 长 按 Overview 按 钮 ， 进 入 多 窗口 模 


式 ， 此 时 的 打印 信息 如 图 13.16 所 示 。 
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com. example. materialtest D/MaterialTest: onPause 
com. example. materialtest D/MaterialTest: onStop 
com. example. materialtest D/MaterialTest: onDestroy 
com. example. materialtest D/MaterialTest: onCreate 
com. example. materialtest D/MaterialTest: onStart 
com. example. materialtest D/MaterialTest: onResume 


com. example. materialtest D/MaterialTest: onPause 


图 13.16 进入 多 窗口 模式 时 的 打印 日 志 


你 会 MaterialTest 中 的 MainActivity 经 历 了 一 个 重新 创建 的 过 程 。 
其 全 是 正常 现象 ， 因 为 进入 多 窗口 模式 后 活动 的 大 小 发 生 了 比较 大 
0 此 时 默认 是 会 重新 创建 活动 的 。 除 此 之 外 ， 像 横竖 屏 切 换 也 是 
会 重新 创建 活动 的 。 进 入 多 窗口 模式 后 ，MaterialTest 变 成 了 暂停 状态 。 


接着 在 Overview 列 表 界 面 选中 LBSTest 程 序 ， 打 印信 息 如 图 13.17 所 示 。 
Verbose 司 | @- Test: 3) 


com. example. lbstest D/LBSTest: onCreate 

















com. example. lbstest D/LBSTest: onStart 


com. example. lbstest D/LBSTest: onResume 


图 13.17 启动 LBSTest 时 的 打印 日 志 


可 以 看 到 ， 现 在 LBSTest 的 oncreate()、 i 
次 得 到 了 执行 ， 说 明 现 在 LBSTest 变 成 了 运行 状态 


接 下 来 我 们 可 以 随意 操作 一 下 MaterialTest 程 序 ， 然 后 观察 logcat 中 的 打 
印 日 志 ， 如 图 13.18 所 示 。 
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com. example. lbstest D/LBSTest: onPause 





com. example. materialtest D/MaterialTest: onResume 


图 13.18 





现在 LBSTest 的 onPause() 方 法 得 到 了 执行 ， 而 MaterialTest 的 onResume( ) 
方法 得 到 了 执行 ， 说 明 LBSTest 变 成 了 暂停 状态 ，MaterialTest 则 变 成 了 
运行 状态 ， 这 和 我 们 在 本 小 节 开 头 所 分 析 的 生命 周期 行为 是 一 致 的 。 


了 解 了 多 窗口 模式 下 活动 的 生命 周期 规则 ， 那 么 我 们 在 编写 程序 的 时 
候 ， 就 可 以 将 一 些 关 键 性 的 点 考虑 进去 了 。 比 如 说 ， 在 多 窗口 模式 下 ， 
用 户 仍然 可 以 看 到 处 于 暂停 状态 的 应 用 ， 那 么 像 视频 播放 堪 之 类 的 应 用 
在 此 时 就 应 该 能 继续 播放 视频 才 对 。 因 此 ， 我 们 最 好 不 要 在 活动 的 
onPause() 方 法 中 去 处 理 视频 播放 堪 的 暂停 逻辑 ， 而 是 应 该 在 onstop() 方 
法 中 去 处 理 ， 并 且 在 onstart() 方 法 恢复 视频 的 播放 。 


另外 ， 针 对 于 进入 多 窗口 模式 时 活动 会 被 重新 创建 ， 如 果 你 想 改 变 这 一 
默认 行为 ， 可 以 在 AndroidManifest.xml 中 对 活动 进行 如 下 配置 : 








anges="orientation|keyboardHidden|screenSize|screenLayout"> 


加 入 了 这 行 配 置 之 后 ， 不 管 是 进入 多 窗口 模式 ， 还 是 横竖 屏 切 换 ， 活 动 
都 不 会 被 重新 创建 ， 而 是 会 将 屏幕 发 生变 化 的 事件 通知 到 Activity 的 
onconfigurationCchanged() 方 法 当中 。 因 此 ， 如 果 你 想 在 屏幕 发 生变 化 
的 时 候 进 行 相应 的 逻辑 处 理 ， 那 么 在 活动 中 重 写 
onConfigurationCchanged() 方 法 即 可 。 


13.6.3 ”禁用 多 窗口 模式 

多 窗口 模式 虽然 功能 非常 强大 ， 但 是 未 必 就 适用 于 所 有 的 程序 。 比 如 

说 ， 手 机 游戏 就 非常 不 适合 在 多 窗口 模式 下 运行 ， 很 难 想 象 我 们 如 何 一 
边 玩 着 游戏 ， 一 边 又 操作 着 其 他 应 用 。 因 此 ，Android 还 是 给 我 们 提供 
了 禁用 多 窗口 模式 的 选项 ， 如 果 你 非常 不 希望 自己 的 应 用 能 够 在 多 窗口 








模式 下 运行 ， 那 么 就 可 以 将 这 个 功能 关闭 兵 。 


禁用 多 窗口 模式 的 方法 非常 简单 ， 只 需要 在 AndroidManifest.xml 的 
<application> 或 <activity> 标 签 中 加 入 如 下 属性 即 可 : 


android:resizeableActivity=["true" | "false"] 








其 中 ，true 表 示 应 用 文 持 多 窗口 模式 ，false 表 示 应 用 不 文 持 多 窗口 模 
式 ， 如 果 不 配置 这 个 属性 ， 那 么 默认 值 为 true。 


现在 我 们 将 MaterialTest 程 序 设置 为 不 文 持 多 窗口 模式 ， 如 下 所 不 : 


<application 
android:resizeableActivity="false"> 


</application> 





重新 运行 程序 ， 然 后 长 按 Overview 按 钮 ， 结 果 如 图 13.19 所 示 。 


三 Fruits 





图 13.19 不 支持 多 窗口 模式 时 长 按 Overview 按 钮 


可 以 看 到 ， 现 在 是 无 法 进入 到 多 窗口 模式 的 ， 而 且 屏 幕 下 方 还 会 弹出 一 
个 Toast 提 示 来 告知 用 户 ， 当 前 应 用 不 文 持 多 窗口 模式 。 


虽说 android:resizeableActivity 这 个 属性 的 用 法 很 简单 ， 但 是 它 还 存 
在 着 一 个 问题 ， 就 是 这 个 属性 只 有 当 项 目的 targetSdkVersion 指 定 成 24 或 
者 更 高 的 时 候 才 会 有 用 ， 人 否则 这 个 属性 是 无 效 的 。 那 么 比如 说 我 们 将 项 
目的 targetSdkVersion 指 定 成 23， 这 个 时 候 尝 试 进入 多 窗口 模式 ， 结 果 如 
图 13.20 所 示 。 





App may not work with split-screen. 


LBSTest 





图 13.20 ”targetSdkVersion 指 定 成 23 时 长 按 Overview 按 钮 


可 以 看 到 ， 虽 说 界面 上 弹出 了 一 个 提示 ， 告 知 我 们 此 应 用 在 多 窗口 模式 
下 可 能 无 法 正常 工作 ， 但 还 是 进入 了 多 窗口 模式 。 那 这 样 我 们 就 非常 头 
疼 了 ， 因 为 有 很 多 的 老 项 目 ， 它 们 的 targetSdkVersion 都 没有 指定 到 24， 
岂 不 是 这 些 老 项 目 都 无 法 禁用 多 窗口 模式 了 ? 


针对 这 种 情况 ， 还 有 一 种 解决 方案 。Android 规 定 ， 如 果 项 目 指定 的 
targetSdkVersion 低 于 24， 并 且 活 动 是 不 允许 横竖 屏 切 换 的 ， 那 么 该 应 用 
也 将 不 文 持 多 窗口 模式 。 








默认 情况 下 ， 我 们 的 应 用 都 是 可 以 随 着 手机 的 旋转 自由 地 横竖 屏 切 换 
的 ， 如 果 想 要 让 应 用 不 允许 横竖 屏 切 换 ， 那 么 就 需要 在 
AndroidManifest.xml 的 <activity> 标 签 中 加 入 如 下 配置 : 


android:screenOrientation=["portrait" | "landscape"] 








其 中 ，portrait 表 示 活 动 只 支持 竖 屏 ，landscape 表 示 活 动 只 支持 横 屏 。 
当然 android: ”screenorientation 属 性 中 还 有 很 多 其 他 可 选 值 ， 不 过 最 
和 常用 的 就 是 portrait 和 landscape 了 。 


现在 我 们 将 MaterialTest 的 MainActivity 设 置 为 只 支持 竖 屏 ， 如 下 所 示 : 








重新 运行 程序 之 后 你 会 发 现 MaterialTest 现 在 不 支持 横竖 屏 切 换 了 ， 此 时 
长 按 Overview 按 钮 会 阐 出 和 图 13.19 中 一 样 的 提示 ， 说 明 我 们 已 经 成 功 禁 
用 多 窗口 模式 了 。 


13.7 ” Lambda 表达 陈 


Java 8 中 着 实 引 入 了 一 些 非常 有 特色 的 功能 ， 如 Lambda 表 达 式 、stream 
API、 接 口 默认 实现 ， 等 等 。 虽 说 我 们 本 地 安装 的 JDK 就 是 Java ” 8 的 版 
本 ， 不 过 本 书 中 却 一 直 没有 使 用 过 任何 Java 8 的 新 特性 。 这 主要 是 因为 
我 考虑 到 你 对 Java 8 的 新 语法 规则 可 能 并 不 熟悉 ， 如 果 直 接应 用 到 项 目 
中 的 话 ， 容 易 让 代码 难以 理解 ， 因 此 这 里 我 就 准备 单独 使 用 一 节 的 篇 幅 
来 对 Java 8 的 新 特性 进行 讲解 。 


虽然 刚才 已 经 提 到 了 几 个 Java 8 中 的 新 特性 ， 不 过 现在 能 够 立即 应 用 到 
项 目 当中 的 也 就 只 有 Lambda 表 达 式 而 已 ， 因 为 stream API 和 接口 默认 实 
现 等 特性 都 只 支持 Android 7.0 及 以 上 的 系统 ， 我 们 显然 不 可 能 为 了 使 用 
这 些 新 特性 而 放弃 兼容 众多 低 版 本 的 Android 手 机 。 而 Lambda 表 达 式 却 
最 低 兼 容 到 Android “2.3 系统 ， 基 本 上 可 以 算是 覆盖 所 有 的 Android 手 机 
了 ， 那 么 本 节 中 我 们 就 来 重点 学 习 一 下 Java 8 中 的 Lambda 表 达 式 。 


Lambda 表达 式 本 质 上 是 一 种 匿名 方法 ， 它 既 没 有 方法 名 ， 也 即 没 有 访 
问 修饰 符 和 返回 值 类 型 ， 使 用 它 来 编写 代码 将 会 更 加 人 简洁， 也 更 加 易 
谈 。 

如 果 想 要 在 Android 项 目 中 使 用 Lambda 表 达 式 或 者 Java 8 的 其 他 新 特性 ， 
首先 我 们 需要 在 app/build.gradle 中 添加 如 下 配置 : 


android { 

















defaultConfig { 


jackoptions .enabled = true 


avaVersion.VERSION 1 8 
avaVersion.VERSION 1 8 


So 
上 岂 
上. 
ro 
~~ 
(CC 
We Re 





之 后 就 可 以 开始 使 用 Lambda 表 达 式 来 编写 代码 了 ， 比 如 说 传统 情况 下 
开局 一 个 子 线程 的 写法 如 下 : 


new Thread(new Runnable() { 
@override 
() 


public void run 
// 处 理 具 体 的 逻辑 





}).start(); 


而 使 用 Lambda 表 达 式 则 可 以 这 样 写 : 


是 不 是 很 神奇 ? 不 管 是 从 代码 行 数 上 还 是 缩 进 结构 上 来 看 ，“Lambda 表 
达 式 的 写法 明显 要 更 加 精简 。 


那么 为 什么 我 们 可 以 使 用 这 么 神奇 的 写法 呢 ? 这 是 因为 Thread 类 的 构造 
函数 接收 的 参数 是 一 个 Runnable 接 口 ， 并 且 该 接口 中 只 有 一 个 待 实现 方 
法 。 我 们 查看 一 下 Runnable 接 口 的 源码 ， 如 下 所 示 : 


public interface Runnable { 








/x* 
* Starts executing the active part of the class' code. This method is 
* called when a t is started that has been created with a class which 
implements {@code Runnable}. 


tf 
public void run(); 


凡是 这 种 只 有 一 个 待 实现 方法 的 接口 ， 都 可 以 使 用 Lambda 表 达 式 的 写 
法 。 比 如 说 ， 通 利 创 建 一 个 类 似 于 上 述 接口 的 匿名 类 实现 需要 这 样 写 : 


Runnable runnable = new Runnable() { 


public void run() { 
// 添加 具体 的 实现 
. 


而 有 了 Lambda 表 达 式 之 后 我 们 就 可 以 这 样 写 了 : 


Runnable runnable1 = () -> { 
// 添加 具体 的 实现 
}; 





本 解 了 Lambda 表 达 式 的 基本 写法 ， 接 下 来 我 们 尝试 目 定 义 一 个 接口 ， 
然后 再 使 用 Lambda 表 达 式 的 方式 进行 实现 。 


新 建 一 个 MyListener 接 口 ， 代 码 如 下 所 示 : 


public interface MyListener { 
String doSomething(String a, int b); 


} 


MyListener 接 口中 也 只 有 一 个 待 实现 方法 ， 这 和 Runnable 接 口 的 结构 是 
基本 一 致 的 。 唯 一 不 同 的 是 ，MyListener 中 的 dosomething() 方 法 是 有 参 
数 并 且 有 返回 值 的 ， 那 么 我 们 就 来 看 一 看 这 种 情况 下 该 如 何 使 用 
Lambda 表 达 式 进行 实现 。 

其 实 写法 也 是 比较 相似 的 ， 使 用 Lambda 表 达 式 创建 MyListener 接 口 的 匿 
名 实现 写法 如 下 : 


}; 





可 以 看 到 ，dosomething() 方 法 的 参数 直接 写 在 括号 里 面 就 可 以 了 ， 而 
返回 值 则 仍然 像 往 常 一 样 ， 写 在 具体 实 现 的 最 后 一 行 即 可 。 


另外 ，Java 还 可 以 根据 上 下 文 上 自动 推 朵 出 Lambda 表 达 式 中 的 参数 类 型 ， 
因此 上 面 的 代码 也 可 以 简化 成 如 下 写法 : 


MyListener listener = (a, b) -> { 
String result =a+b; 
return result; 


}; 





Java 将 会 自动 推断 出 参数 a 是 string 类 型 ， 参 数 b 是 int 类 型 ， 从 而 使 得 我 
们 的 代码 变 得 更 加 精简 了。 


接 下 来 举 个 具体 的 例子 ， 比 如 说 现在 有 一 个 方法 是 接收 MyListener 参 数 
的 ， 如 下 所 示 : 


public void hello(MyListener listener) { 
String a = "Hello Lambda"; 
int b = 1024; 





String result = listener.doSomething(a, b); 
Log.d("TAG", result); 


我 们 在 调用 hello() 这 个 方法 的 时 候 就 可 以 这 样 写 : 


hello((a, b) -> { 
String result =a+b; 
return result; 

}); 


那么 dosomething() 方 法 就 会 将 a 和 b 两 个 参数 进行 相 加 ， 从 而 最 终 的 打印 
结果 就 会 是 “Hello Lambda1024”。 


现在 你 已 经 将 Lambda 表 达 式 的 写法 基本 都 掌握 了 ， 接 下 来 我 们 看 一 看 
ee 常用 的 功能 是 可 以 使 用 Lambda 表 达 式 进行 蔡 换 
A 


其 实 只 要 是 符合 接口 中 只 有 一 个 竺 实现 方法 这 个 规则 的 功能 ， 都 是 可 以 
使 用 Lambda 表 达 式 来 编写 的 。 除 了 刚才 举例 说 明 的 开局 子 线程 之 外 ， 
还 有 像 设置 点 击 事件 之 类 的 功能 也 是 非常 适合 使 用 Lambda 表 达 式 的 。 


传统 情况 下 ， 我 们 给 一 个 按钮 设置 点 击 事件 需要 这 样 写 : 


RUEtan Ee 入 = (Bu ht ny fi DV Cn id.button); 
butto eton nen ckLi er(ne ckListener() { 








G0 Te 

publi nClick(View v) { 
/7 处 理 人 

} 


而 使 用 Lambda 表 达 式 之 后 ， 就 可 以 将 代码 简化 成 这 个 样子 了 : 


ckL1iste 


Bu tte = (Butto ") findVvi iewByTd(R.i id.button); 
butt er((v) -> { 

/7 人 
}); 





另外 ， 当 接口 的 待 实现 方法 有 且 只 有 一 个 参数 的 时 候 ， 我 们 还 可 以 进 一 
步 简 化 ， 将 参数 外 面 的 括号 去 挥 ， 如 下 所 示 : 


Butto by tton = (Butto ") 人 navi iewById(R.id.button); 

button. seton Cl ckListener(v -> { 
7 “处理 点 击 事件 

}); 


这 样 我 们 就 将 Lambda 表 达 式 的 主要 内 容 都 掌握 了 。 当 然 ， 有 些 人 可 能 
并 不 喜欢 Lambda 表 达 式 这 种 极 简 主 义 的 写法 。 不 管 你 喜欢 与 否 ，Java 8 
对 于 哪 一 种 写法 都 是 完全 文 持 的 ， 至 于 到 底 要 不 要 使 用 Lambda 表 达 式 
其 实 全 凭 个人， 多 一 种 选择 总 归 不 是 一 件 坏事 情 。 








13.8 ”总 结 


整整 13 章 的 内 容 你 已 经 全 部 学 完了 ! 本 书 的 所 有 知识 点 也 到 此 结束 ， 是 
不 是 感 党 有 些 油 动 呢 ? 下 面 就 让 我 们 来 回顾 和 总 结 一 下 这 么 久 以 来 学 过 
的 所 有 东西 吧 。 


这 13 章 的 内 容 不 算 很 多 ， 但 却 已 经 把 Android 中 绝 大 部 分 比较 重要 的 知 
识 点 都 覆盖 到 了 。 我 们 从 搭建 开发 环境 开始 学 起 ， 后 面 逐 步 学 习 了 四 大 
组 件 、UI、 碎 片 、 数 据 存储 、 多 媒体 、 网 络 、 定 位 服务 、Material 
Design 等 内 容 ， 本 章 中 又 学 习 了 如 全 局 获取 Context、 定 制 日 志 工 具 、 调 
试 程序 、 多 窗口 模式 编程 、Lambda 表 达 式 等 高 级 技巧 ， 相 信 你 已 经 从 
一 名 初学 者 晓 变 成 一 位 Android 开 发 好 手 了 。 


不 过 ， 虽 然 你 已 经 储备 了 足够 多 的 知识 ， 并 掌握 了 很 多 的 最 佳 实践 技 
巧 ， 但 是 你 还 从 来 没有 真正 开发 过 一 个 完整 的 项 目 ， 也 许 在 将 所 有 学 到 
的 知识 混合 到 一 起 使 用 的 时 候 ， 你 会 感到 有 些 手足 无 措 。 因 此 ， 前 进 的 
脚步 仍然 不 能 停 下 ， 下 一 半 中 我 们 会 结合 前 面 半 市 所 学 的 内 容 ， 一 起 开 
发 一 个 天 气 预 报 程 序 。 锻 炼 的 机 会 可 干 万 不 能 错过 ， 赶 快 进入 到 下 一 章 
吧 。 














第 14 章 “进入 实战 一 “开发 酷 欧 天 气 


我 们 将 要 在 本 章 中 编写 一 个 功能 较为 完整 的 天 气 预报 程序 ， 学 习 了 这 人 么 
入 的 Android 开 发 ， 现 在 终于 到 了 考核 验收 的 时 候 了 。 那 么 第 一 步 我 们 
需要 给 这 个 软件 起 个 好 听 的 名 字 ， 这 里 就 叫 它 酷 欧 天 气 吧 ， 瑞 文 名 就 叫 
作 Cool Weather。 确 定 了 名 字 之 后 ， 下 面 就 可 以 开始 动手 了 。 





14.1 ”功能 需求 及 拉 术 可 行 性 分 析 


在 开始 编码 之 前 ， 我 们 需要 先 对 程序 进行 需求 分 析 ， 想 一 想 酷 网 天 气 中 
应 该 具备 哪些 功能 。 将 这 些 功能 全 部 整理 出 来 之 后 ， 我 们 才 好 动手 去 一 
一 实现 。 这 里 我 认为 酷 欧 天 气 中 至 少 应 该 具备 以 下 功能 : 








。 可 以 多 列 出 全 国 所 有 的 省 、 市 、 县 ; 

。 可 以 查看 全 国 任 意 城市 的 天 气 信 息 ; 

。 可 以 自由 地 切换 城市 ， 去 查看 其 他 城市 的 天 气 ; 
。 提供 手动 更 新 以 及 后 台 目 动 更 新 天 气 的 功能 。 


虽然 看 上 去 只 有 4 个 主要 的 功能 点 ， 但 如 果 想 要 全 部 实现 这 些 功能 却 需 
要 用 到 UI、 网 络 、 数 据 存储 、 服 务 等 技术 ， 因 此 还 是 非 第 考验 你 的 综合 
应 用 能 力 的 。 不 过 好 在 这 些 技术 在 前 面 的 章节 中 我 们 全 部 都 学 习 过 了 ， 
只 要 你 学 得 用 心 ， 相 信 完 成 这 些 功能 对 你 来 说 并 不 难 。 


分 析 完 了 需求 之 后 ， 接 下 来 就 要 进行 技术 可 行 性 分 析 了 。 首 先 需 要 考虑 
的 一 个 问题 就 是 ， 我 们 如 何 才能 得 到 全 国 省 市 县 的 数据 信息 ， 以 及 如 何 
才能 获取 到 每 个 城市 的 天 气 信息 。 比 较 遗 憾 的 是 ， 现 在 网 上 免费 的 天 和 气 
预报 接口 已 经 越 来 越 少 ， 很 多 之 前 可 以 使 用 的 接口 都 慢 慢 关闭 卸 了 ， 包 
括 本 书 第 1 版 中 使 用 的 中 国 天 气 网 的 接口 。 因 此 ， 这 次 我 也 是 特意 用 心 
去 找 了 一 些 更 加 稳定 的 天 气 预报 服务 ， 比 如 彩云 天 气 以 及 和 风 天 气 都 非 
各 不 错 。 这 两 个 天 气 预 报 服务 虽说 都 是 收费 的 ， 但 它们 每 天 都 提供 了 一 
定 次 数 的 免费 天 气 预报 请 求 。 其 中 彩云 天 气 的 数据 更 加 实时 和 专业 ， 可 
以 将 天 气 预 报 精确 到 分 钟 级 ， 每 天 提供 1000 次 免费 请 求 ， 和 风 天 气 的 数 
气相 对 简单 一 些 ， 比 较 适 合 新 手 学 习 ， 每 天 提供 3000 次 免费 请 求 。 那 么 
简单 起 见 ， 这 里 我 们 就 使 用 和 风 天 气 来 作为 天 气 预 报 的 数据 来 源 ， 每 天 
3000 次 的 免费 请 求 对 于 学 习 而 言 已 经 是 相当 充足 了 。 


解决 了 天 气 数据 的 问题 ， 接 下 来 还 需要 解决 全 国 省 市 县 数据 的 问题 。 同 
样 ， 现 在 网 上 也 没有 一 个 稳定 的 接口 可 以 使 用 ， 那 么 为 了 方便 你 的 学 
习 ， 我 专门 以 设 了 一 人 台 服 务 怖 用 于 提供 全 国 所 有 省 市 县 的 数据 信息 ， 从 

















而 帮 你 把 道路 都 铺 平 了 。 


那么 下 面 我 们 来 看 一 下 这 些 接口 的 具体 用 法 。 比 如 要 想 多 列 出 中 国 所 有 
的 省 份 ， 只 需 访 问 如 下 地 址 : 


http://guolin.tech/api/china 





服务 器 会 返回 我 们 一 段 JSON 格 式 的 数据 ， 其 中 包含 了 中 国 所 有 的 省 份 
名 称 以 及 省 份 d， 如 下 所 示 : 























[{"id":1, "name":" 北 京 "}, {"id":2, "name" eh :3, "name" "天 津 有 Re id" :4, "name" ; "重庆 " PoC , "name": "香港 "} 
{"id":6, "name": “澳门 }, {"id":7, "name":" 人 台湾"}, {"id":8, "namen "黑龙 江 " }, fe id":9, "name": "吉林"}， 各 人 
{"id":11, "name":" 内 蒙古 "}, {"id":12, "name" "河北 "} {"id" :13， "name" 河南 "}， 人 id" :14, ”namef sn 山 曾 "fnid":15vnamen :nl 
东 ! dl6 nane 和 {"id":17, "name": "浙江 "}, {"id":18, "name" 汪 福 建 中 ， {"id":19, "name" : "江西 "}, {"id" :20,， 'name":" 安 
徽 "}, {"id":21,"name":" 湖 北 "}，，{"id":22, "name":" 湖 南 "}, {"id" :23, "name" 1 东 "3}, {"id":24, "name": "让 西 " }， {"id":25, "name":" 海 
南 "}, {"id":26, "name" sh {an me":" 云南 " {"id":28, namen JY}, oid" 29, name: "西藏 "}, {"id":309, "name":" 陕 
西 "}，{"id":31, "name":" 宁 夏 "}, {"id":32,"name":" 甘 肃 "}, {"id":33, "name":" 青 青海" }, {"id":34,"name" "新 疆 " }] 


可 以 看 到 ， 这 是 一 个 JSON 数 组 ， 数 组 中 的 每 一 个 元 素 都 代表 着 一 个 省 
份 。 其 中 ， 北 京 的 id 是 1， 上 海 的 id 是 2。 那 么 如 何 才 能 知道 某 个 省 内 有 
哪些 城市 呢 ? 其 实 也 很 简单 ， 比 如 江苏 的 id 是 16， 访 问 如 下 地 址 即 可 : 


http://guolin.tech/api/china/16 





也 就 是 说 ， 只 需要 将 省 份 id 添加 到 url 地 址 的 最 后 面 就 可 以 了 ， 现 在 服务 
# 返 回 的 数据 如 下 : 


te :113, "Name" 京 "}, {"id":114, "name": "无 锡 "}, {"id" :115, a "镇 江 " {" 3 :116, "name": "苏州"}, {"id":117, "name":" 南 
通 "}, {"id":118, Shame” :扬州 " jz TU， name 城 "}, fid" :129, "name": "徐州 "}, {"id":121,"name":" 淮 
安 "}，{"id":122, "name":" 连 云 港 "}, {"id":123, "name":" 常 州 "},{" jd :124, "name" "泰州 "}， i id":125, "name": "宿迁 "}] 


这 样 我 们 就 得 到 江苏 省 内 所 有 城市 的 信息 了 ， 可 以 看 到 ， J 
据 格 式 和 刚才 查看 省 份 信 息 时 返回 的 数据 格式 是 一 样 的 。 相 信 此 时 你 已 
经 可 以 举一反三 了 ， 比 如 说 苏州 的 id 是 116， 那 么 想 要 知道 苏州 市 下 又 
有 哪些 县 和 区 的 时 候 ， 只 需 访 问 如 下 地 址 : 


http://guolin.tech/api/china/16/116 








这 次 服务 器 返回 的 数据 如 下 : 


[{"id":937, "name":" 苏 州 ", "weather_id":"CN191199491"]}， 


3 id":"CN191190492"}， 
, 








Wy id":" 
he id":"CN101190405" i 
'id":942, "name":" 吴 江 ", "weather_id":"CN101190407"}, 
'id":943, "name":" 太 仓 ", "weather_id":"CN101199408"}] 


rm 一 一 一 
bb bb 
aann 

2 

rg 

© 

号 

中 

三 


通过 这 种 方式 ， 我 们 就 能 把 全 国 所 有 的 省 、 市 、 县 都 罗列 出 来 了 。 那 么 
解决 了 省 市 县 数据 的 获取 ， 我 们 又 怎样 才能 查看 到 具体 的 天 气 信 息 呢 ? 
这 惑 必 须要 用 到 每 个 地 区 对 应 的 天 气 id 了 。 观 察 上 面 返回 的 数据 ， 你 会 
发 现 每 个 县 或 区 都 会 有 一 个 weather id， 拿 着 这 个 id 再 去 访问 和 风 天 和 气 
的 接口 ， 就 能 够 获取 到 该 地 区 具体 的 天 气 信 息 了 。 


下 面 我 们 来 看 一 下 和 风 天 和 气 的 接口 该 如 何 使 用 。 首 先 你 需要 注册 一 个 目 
己 的 账号 ， 注 册 地 址 是 http://guolin.tech/api/weather/register。 注 册 好 了 之 
后 使 用 这 个 账号 登录 ， 就 能 看 到 自己 的 API Key， 以 及 每 天 剩余 的 访问 
次 数 了 ， 如 图 14.1 所 示 。 














我 的 产品 计划 : 免费 用 户 购买 ”有效期 ; 永久 
个 人 认证 key : bc0418b57b2d4918819d3974ac1285d9 
条 余 每 天 访问 流量 : 3000 次 





图 14.1 API Key 和 每 天 剩余 访问 次 数 
有 了 API Key， 再 配合 刚才 的 weather_id， 我 们 就 能 获取 到 任意 城市 的 天 


气 信 息 了 。 比 如 说 苏州 的 weather_ id 是 CN101190401， 那 么 访问 如 下 接 
口 即 可 查看 苏州 的 天 气 信息 : 





http://guolin.tech/api/weather?cityid=CN101190401&key=bc0418b57b2d4918819d3974ac1285d9 


其 中 ，cityid 部 分 填 入 的 就 是 竺 查看 城市 的 weather_id，key 部 分 填 入 的 融 
古 我 们 申请 到 的 API Key。 这 样 ， 服 务 絮 束 会 把 苏州 详细 的 天 气 信息 以 
JSON 格 式 返 回 给 我 们 了 。 不 过 ， 由 于 返回 的 数据 过 于 复杂 ， 这 里 我 做 
了 一 下 精简 处 理 ， 如 下 所 示 : 


"Heweather": [ 
{ 





返回 数据 的 格式 大 体 上 束 厦 这 个 杆子 了 ， 其 中 status 代 表 请 求 的 状 

态 ，ok 表 示 成 功 。basic 中 会 包含 城市 的 一 些 基本 信息 ，aqi 中 会 包含 当 

前 空气 质量 的 情况 now 中 会 包含 当前 的 天 气 信 息 ，suggestion 中 会 包 
一 些 天 气相 关 的 生活 建议 ，daily_forecast 中 会 包含 未 来 儿 天 的 天 气 

信息 。 访问 http://guolin.tech/api/weather/doc 这 个 网 址 可 以 查看 更 加 详细 

的 文档 说 明 。 


数据 都 能 获取 到 了 之 后 ， 接 下 来 就 是 JSON 解 析 的 工作 了 ， 这 对 于 你 来 
说 应 该 很 轻松 了 吧 ? 


确定 了 技术 完全 可 行 之 后 ， 接 下 来 就 可 以 开始 编码 了 。 不 过 别 着 和 急 ， 我 
们 准备 让 酯 欧 天 气 成 为 一 个 开源 软件 ， 并 使 用 GitHub 来 进行 代码 托管 ， 
因此 先 让 我 们 进入 到 本 书 最 后 一 次 的 Git 时 间 。 














14.2 ”Git 时 间 | 将 代码 托管 到 


GitHub 上 


经 过 前 面 几 章 的 学 习 ， 相 信 你 已 经 可 以 非常 熟练 地 使 用 Git 了 。 本 节 依 
然 是 Git 时 间 ， 这 次 我 们 将 会 把 酷 欧 天 气 的 代码 托管 到 GitHub 上 面 。 


GitHub 是 全 球 最 大 的 代码 托管 网 站 ， 主 要 是 借助 Git 来 进行 版 本 控制 
的 。 任 何 开源 软件 都 可 以 免费 地 将 代码 提交 到 GitHub 上 ， 以 零 成 本 的 代 
价 进行 代码 托管 。GitHub 的 官网 地 址 是 https://github.com/。 官 网 的 首页 
如 图 14.2 所 示 。 





( How People bwdd sofn， x 


一 © 8 https//github.com 
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图 14.2 GitHub 首页 


首先 你 需要 有 一 个 GitHub 账 号 才能 使 用 GitHub 的 代码 托管 功能 ， 点 击 
Sign up for GitHub 按 钮 进行 注册 ， 然 后 填 入 用 户 名 、 邮 箱 和 密码 ， 如 图 
14.3 所 示 。 


Create your personal account 


Username 

guolindev dd 
This will be your USsername 一 YOU can enter your organization s Username next. 
Email Address 


sinyu890807@163.com dk 


You will occasionally receive account related emails. We promise not to share your 
emall with anyone. 


Password 


Use at least one lowercase letter, one numeral, and seven characters, 


By clicking on “Create an account" below, you are agreeing to the Terms 
of Service and the Privacy Policy. 


Create an account 


图 14.3 注册 账号 


点 击 Create an account 按 钮 来 创建 账户 ， 接 下 来 会 让 你 选择 个 人 计划 ， 收 
费 计 划 有 创建 私人 版 本 库 的 权限 ， 而 我 们 的 酪 欧 天 气 是 开源 软件 ， 所 以 
这 里 选择 免费 计划 就 可 以 了 ， 如 图 14.4 所 示 。 


Choose your personal plan 
® Unlimited public repositories for free. 


乙 Unlimited private repositories for 9$7/month, (view in CNY) 


Dont worry, you can cancel or upgrade at any time. 


[ Help me set up an organization next 
Organizations are separate from personal accounts and are best suited for 
businesses who need to manage permissions for many employees. 
Learn more about organizations， 


图 14.4 选择 免费 计划 
接着 点 击 Continue 按 钮 会 进入 一 个 问卷 调查 界面 ， 如 图 14.5 所 示 。 


How would you describe your level of programming experience? 


© Totally new to programming J Somewhat experienced 


What do you plan to use GitHub for? (check all that apply) 
LU School projects [| Research 


局 Development 局 Project Management 


Which is closest to how you would describe yourself? 
J Im a hobbyist 已 Tm a professional 


J Other (please specify) 


What are you interested in? 


e.g. tutorials, android, ruby, web-development machine-learning, open-source 


skip this step 


图 14.5 问卷 调查 界面 


J Very experienced 


DU Design 


| Other (please specify) 


) I'm a student 








如 果 你 对 这 个 有 兴趣 就 填写 一 下 ， 没 兴趣 的 话 直接 点 击 最 下 方 的 skip 


this step 中 过 就 可 以 了 。 


这 样 我 们 束 把 账号 注册 好 了 ， 会 自动 跳 转 到 GitHub 的 个 人 主页 ， 如 图 


14.6 所 示 。 


© pull requests issues Gist +» 办 -> 


Learn Git and GitHub without any codel 


Using the Hello World guide, you'l| create a repository, start a branch 


Write comments, and open a pull request 


Read the guide Start a project 


图 14.6” GitHub 个 人 主页 


接 下 来 就 可 以 点 击 Start a project 按 钮 来 创建 一 个 版 本 库 了 。 由 于 我 们 是 
刚刚 注册 的 账号 ， 在 创建 版 本 库 之 前 还 需要 做 一 下 邮箱 验证 ， 验 证 成 功 
之 后 就 能 开始 创建 了 。 这 里 将 版 本 库 命 名 为 coolweather， 然 后 选择 添加 
一 个 Android 项 目 类 型 的 .gitignore 文 件 ， 并 使 用 Apache License 2.0 来 作为 
酷 欧 天 气 的 开源 协议 ， 如 图 14.7 所 示 。 








Owner Repository name 


WE guolindev ~ / coolweather Vv 


Great repository names are short and memorable. Need inspiration? How about glowing-octo-adventure. 


Description (optional) 


@ |: | Public 


”Anyone can see this repository, You choose who can commit. 


宣 Private 


You choose who can see and commit to this repository. 


四 Initialize this repository with a README 
This will let you immediately clone the repository to your computer. Skip this step if you're importing an existing repository, 


Add ,gitignore: Android Add a license: Apache License 2.0 ~ 


Create repository 


图 14.7 ”创建 版 本 库 


接着 点 击 Create repository 按 钮 ，coolweather 这 个 版 本 库 就 创建 完成 了 ， 
如 图 14.8 所 示 。 版 本 库 主页 地 址 
是 https://github.com/guolindev/coolweather。 


v1 0 1 


Master = New pull request Createnew file = Upload files Find file OClone or downioad ~ 


如 guolindev intt 


围 READMEmd 


coolweather 


图 14.8 版 本 库 主页 

可 以 看 到 ，GitHub 己 经 自动 帮 我 们 创建 了 .gitignore、LICENSE 和 
README.md 这 3 个 文件 ， 其 中 编辑 README.md 文 件 中 的 内 容 可 以 修改 
酷 欧 天 气 版 本 库 主 页 的 描述 。 

创建 好 了 版 本 库 之 后 ， 我 们 就 需要 创建 酪 欧 天 气 这 个 项 目 了 。 在 
Android Studio 中 新 建 一 个 Android 项 目 ， 项 目 名 叫 作 CoolWeather， 包 名 
叫 作 com.coolweather.android， 如 图 14.9 所 示 。 





New Project 


人 Android Studio 


Configure your new project 





Application name: | CoolWeather 


Company Domain: | example.com 





Package name: com.coolweather.android 





器 Indude C++ Support 


Project location: E\source\chapter3\CoolWeather 














图 14.9 ”创建 CoolWeather 项 目 


之 后 的 步骤 不 用 多 说 ， 一 直 点 击 Next 就 可 以 完成 项 目的 创建 ， 所 有 选项 
都 使 用 默认 的 就 好 。 


接 下 来 的 一 步 非 第 重要 ， 我 们 需要 将 远程 版 本 库 克 隆 到 本 地 。 首 先 必须 








知道 远程 版 本 库 的 Git 地 址 ， 点 击 Clone or download 按 钮 就 能 够 看 到 了 ， 


如 图 14.10 所 示 。 
*new file Uploadfiles Find file 


Clone with HTTPS @) Use SSH 


Use Git or checkout with SVN using the web URL， 
nttps://github.com/guolindev/coolweather.g 良 
Open in Desktop Download ZIP 


图 14.10 查看 版 本 库 的 Git 地 址 


点 击 右边 的 复制 按钮 可 以 将 版 本 库 的 Git 地 址 复制 到 剪贴 板 ， 酷 欧 天 气 
版 本 库 的 Git 地 址 是 https://github.com/guolindev/coolweather.git。 


然后 打开 Git Bash 并 切换 到 CoolWeather 的 工程 目录 下 ， 如 图 14.11 所 示 。 


,是 = ,区 or 


$ cd Users/AdministratoryAndroidSstudioProjJects/CoolWeather/ 


$ 





图 14.11 在 Git Bash 中 进入 CoolWeather 工 程 目录 


接着 输入 git clone https://github.com/guolindev/coolweather.git 来 把 远程 版 
本 库 克隆 到 本 地 ， 如 图 14.12 所 示 。 


$ git clone https://github. com/guolindev/coolweather .git 
一 ] ' fd . 


0) ，pack-reused 0 


Unpacking objects: 
Checking connect1ivity... 


图 14.12 将 远程 版 本 库 殉 隆 到 本 地 








看 到 图 中 所 给 的 文字 提示 就 表示 元 隆 成 功 了 人 了 人， 并且 .gitignore、LICENSE 


和 README.md 这 3 个 文件 也 已 经 被 复制 到 了 本 地 ， 可 以 进入 到 
coolweather 目 录 ， 并 使 用 1s -al 命令 查看 一 下 ， 如 图 14.13 所 示 。 


AndroidSstudioProjects/CoolWeather 


coolweather 


~/AndroidstudioProjects/CoolWeather/coolweather 


Admin1istrator 
x 工 Admini et 19 
: Adminis 0 9 
1 Administrator 2 505 三 9 .gitignore 
1 Adminis or 712 558 月 5 9 LICENSE 
1 Administr et 9712 13 八 月 5 9 README.md 





图 14.13 查看 克隆 到 本 地 的 文件 


现在 我 们 需要 将 这 个 目录 中 的 所 有 文件 全 部 复制 粘贴 到 上 一 层 目录 中 ， 
这 样 束 能 将 整个 CoolWeather 工 程 目录 添加 到 版 本 控制 中 去 了。 注意 .git 
是 一 个 隐藏 目录 ， 在 复制 的 时 候 千 万 不 要 漏 掉 。 另 外 ， 上 一 层 目录 中 也 
有 一 个 .gitignore 文 件 ， 人 k 获 羡 即 可 。 复 制 完 之 后 可 以 把 
coolweather 目 录 删 除 掉 ， 最 终 CoolWeather 工 程 的 目录 结构 如 图 14.14 所 
示 。 











Administrator 

Administrator 

Admin1istrator 0 
Administrator 1: 505 59 .gitignore 
AdmTin1str : 48 
Administrator 


:i d. gradle 
8 CoolWeather. 


8 gradle.properties 


8 gradlew 
8 gradle .ba 
N SE 


和 
1 
1 
Wr; 
a 
xX1A 
1A 
1 A 
1 下 
家 
1 上 
X 工具 
1 上 
1 下 
1 上 
1 上 
1 





1S 9712 ,月 5 ‘DME . m 
Administrator 19712 6 八 月 5 21:48 settings.gradle 
图 14.14 CoolWeather 工 程 的 目录 结构 


接 下 来 我 们 应 该 把 CoolWeather 项 目 中 现 有 的 文件 提交 到 GitHub 上 面 ， 
这 惑 很 简单 了 ， 先 将 所 有 文件 添加 到 版 本 控制 中 ， 如 下 所 示 : 


git add . 


然后 在 本 地 执行 提交 操作 : 


git commit -m "First commit." 


最 后 将 提交 的 内 容 同 步 到 远程 版 本 库 ， 也 就 是 GitHub 上面: 


git push origin master 





注意 ， 在 最 后 一 步 的 时 候 GitHub 要 求 输 入 用 户 名 和 密码 来 进行 身份 校 
验 ， 这 这 里 输入 我 们 注册 时 填 入 的 用 户 名 和 密码 就 可 以 了 ， 如 图 14.15 所 
人 No 





$ git push origin master 
Co 74, done. 
up to 4 threads 





图 14.15 将 提交 的 内 容 同 步 到 远程 版 本 库 


这 样 就 已 经 同步 完成 了 ， 现 在 刷新 一 下 酷 欧 天 气 版 本 库 的 主页 ， 你 会 看 
到 刚才 提交 的 那些 文件 已 经 存在 了 ， 如 图 14.16 所 示 。 


$0 tinnuharo1971 First commit,. 


i .idea 

启 app 

条 gradle/wrapper 
加 .gitignore 

园 LUCENSE 

国 README.md 

园 build.gradle 

国 gradle.properties 
国 9radlew 

国 gradlew.bat 


图 settings.gradle 


First commit, 


First commit. 


First commit, 


Initial commit 


Initial commit 


Initial commit 


First commit. 


First commit, 


First commit. 


First commit. 


First commit, 


图 14.16 在 GitHub 上 查看 提交 的 内 容 


Latest commit 8532138 6 minutes ago 


6 minutes ago 
6 minutes ago 
6 minutes ago 

an hourag0 

an hour ago 

an hour ag90 
6 minutes ago 
6 minutes ag0 
6 minutes ago 
6 minutes ago 


6 minutes 3g0 


14.3 ”创建 数据 库 和 表 


从 本 市 开始 ， 我 们 就 要 真正 地 动手 编码 了 ， 为 了 要 让 项 目 能 够 有 更 好 的 
结构 ， 这 里 需要 在 com.coolweather.android 包 下 再 新 建 几 个 包 ， 如 图 
14.17 所 示 。 








加 java 
加 com.coolweather.android 
加 db 
后 gson 
后 service 
后 util 
SH MainActivity 


图 14.17 项 目的 新 结构 


其 中 db 包 用 于 存放 数据 库 模型 相关 的 代码 ，gson 包 用 于 存放 GSON 模 型 
1 service 包 用 于 存放 服务 相关 的 代码 ，util 包 用 于 存放 工具 相 
大 的 代码 。 


根据 14.1 市 进行 的 技术 可 行 性 分 析 ， 第 一 阶段 我 们 要 做 的 就 是 创建 好 数 
据 库 和 表 ， 这 样 从 服务 器 获取 到 的 数据 才能 够 存储 到 本 地 。 关 于 数据 库 
和 表 的 创建 方式 ， 我 们 早 在 第 6 章 中 惑 已 经 学 过 了 。 那 么 为 了 简化 数据 
库 的 操作 ， 这 里 我 准备 使 用 LitePal 来 管理 酷 欧 天 气 的 数据 库 。 


首先 需要 将 项 目 所 需 的 各 种 依赖 库 进行 声明 ， 编 辑 app/build.gradle 文 
件 ， 在 dependencies 闭 包 中 添加 如 下 内 容 : 











androi 11 

up。 okhttp 和 5 okhttp: 3.4.1 
e.gson:gs 

U0 Doriniech oiide: oid.0 


这 里 声明 的 4 个 库 我 们 之 前 都 是 使 用 过 的 ，LitePal 用 于 对 数据 库 进 行 操 
作 ，OkHttp 用 于 进行 网 络 请 求 ，GSON 用 于 解析 JSON 数 据 ，Glide 用 于 


加 载 和 展示 图 片 。 酷 欧 天 气 将 会 对 这 几 个 库 进 行 综合 运用 ， 这 里 直接 一 
次 性 将 它们 都 添加 进来 。 


人 下 数据 库 的 表 结 构 ， 表 的 设计 当然 是 仁者 见 仁 智 者 见 
并 不 是 说 哪 种 设计 就 是 最 规范 最 完美 的 。 这 里 我 准备 建立 3 张 表 : 
0 city、county， 分 别 用 于 存放 省 、 市 、 基 的 数据 信息 。 对 应 到 

实体 类 中 的 话 ， 就 应 该 建 并 Province、cCity、County 这 3 个 类 。 


那么 ， 在 db 包 下 新 建 一 个 Province 类 ， 代 人 码 如 下 所 示 : 


public class Province extends DataSupport { 











private int id; 
private String provinceName; 
private int provinceCode; 
public int getId() { 

return id; 


} 
public void setId(int id) { 
is.1d = 


public String getProvinceName() { 
return provinceName; 


} 


public void setProvinceName(String provinceName) { 
this.provinceName = provinceName; 


public int getProvinceCode() { 
return provinceCode; 


} 


public void setProvincecode(int BE er { 
this.provinceCode = provinceCode 





其 中 ，id 是 每 个 实体 类 中 都 应 该 有 的 字段 ，provinceName 记 录 省 的 名 
字 ，provincecode 记 录 省 的 代号 。 另 外 ，LitePal 中 的 每 一 个 实体 类 都 是 
必须 要 继承 自 Datasupport 类 的 。 


接着 在 db 包 下 新 建 一 个 city 类 ， 代 码 如 下 所 示 : 


public class City extends DataSupport { 





private int id; 
private String cityName; 
private int cityCode; 
private int provinceId ; 
public int getId() { 

return id; 
} 
public void setId(int id) { 

is.id = id; 


public String getCityName() { 
return cityName 
} 


public void setCityName(String cityName) { 
this.cityName = cityName; 
} 


public int getCityCode() { 
return cityCode; 
} 


public void setCityCode(int cityCode) { 
this.cityCode = cityCode; 
} 


public int getProvinceId() { 
return provinceId ; 
} 


public void setProvinceId(int provinceId) { 
this.provinceId = provinceId ; 


其 中 ，cityName 记 录 市 的 名 字 ，citycode 记 录 市 的 代号 ，provinceId 记 
录 当 前 市 所 属 省 的 idq 值 。 


然后 在 db 包 下 新 建 一 个 county 类 ， 代 码 如 下 所 示 : 


public class County extends DataSupport { 





private int id; 

private String countyName; 
private String weatherId; 
private int cityId; 

public int getId() { 


return id; 
} 


public void setId(int id) { 
this.id = id; 
} 


public String getCountyName() { 
return countyName; 
} 


public void setCountyName(String countyName) { 
this.countyName = countyName; 
} 


public String getweatherId() { 
return weatherId; 
} 


public void setweatherId(String weatherId) { 
this.weatherId = weatherId; 
} 


public int getCityId() { 
return cityId; 
} 


public void setCityId(int cityId) { 
this.cityId = cityId; 
} 


y 
/ 
ul 


countyName 记 录 县 的 名 字 ，weatherId 记 录 县 所 对 应 的 天 气 


id，cityId 记 录 当 前 县 所 属 市 的 id 值 。 


可 以 看 到 ， 实 体 类 的 内 容 都 非常 简单 ， 就 是 声明 了 一 些 需 要 的 字段 ， 并 
生成 相应 的 getter 和 setter 方 法 就 可 以 了 。 


接 下 来 需要 配置 litepal.xml 文 件 。 右 击 app/src/main 目 录 
New Directory， 创 建 一 个 assets 目 录 ， 然 后 在 assets 目 录 下 再 新 建 一 
个 litepal.xml 文 件 ， 接 着 编辑 litepal.xml 文 件 中 的 内 容 ， 如 下 所 示 : 


<litepal> 





<dbname value="cool weather" /> 

<version value="1" /> 

<list> 
<mapping class="com.coolweather .android.db.Province" /> 
<mapping class="com.coolweather .android.db.City"” /> 
<mapping class="com.coolweather.android.db.County" /> 

</list> 


</litepal> 


这 里 我 们 将 数据 库 名 指定 成 cool_weather， 数 据 库 版 本 指定 成 1， 并 
将 Province、city 和 county 这 3 个 实体 类 添加 到 映射 列表 当中 。 


最 后 还 需要 再 配置 一 下 LitePalApplication， 修 改 AndroidManifest.xml 中 
的 代码 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.coolweather .android"> 








<application 
android:name="org.litepal.LitepPalApplication" 
android:allowBackup="true 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


</application> 


</manifest> 





这 样 我 们 束 将 所 有 的 配置 都 完成 了 ， 数 据 库 和 表 会 在 首次 执行 任意 数据 
库 操 作 的 时 候 目 动 创建 。 


好 了 ， 第 一 阶段 的 代码 写 到 这 里 就 差不多 了 ， 我 们 现在 提交 一 下 。 首 先 
将 所 有 新 增 的 文件 添加 到 版 本 控制 中 : 


git add . 


接着 执行 提交 操作 : 


git commit -m "加 入 创建 数据 库 和 表 的 各 项 配置 。" 


最 后 将 提交 同步 到 GitHub 上 面 : 


git push origin master 


OK! 第 一 阶段 完工 ， 下 面 让 我 们 赶快 进入 到 第 二 阶段 的 开发 工作 中 
吧 。 


14.4 通 历 全 国 省 市 县 数据 


在 第 二 阶段 中 ， 我 们 准备 把 遍历 全 国 省 市 县 的 功能 加 入 ， 这 一 阶段 需要 
编写 的 代码 量 比较 大 ， 你 一 定 要 跟 上 脚步 。 


我 们 已 经 知道 ， 全 国 所 有 省 市 县 的 数据 都 是 从 服务 器 端 获 取 到 的 ， 因 此 
这 里 和 服务 器 的 交互 是 必 不 可 少 的 ， 所 以 我 们 可 以 在 util 包 下 先 增加 一 
个 Httputil 类 ， 代 码 如 下 所 示 : 


public class HttpUtil { 


public static void sendOkHttpRequest (String address, okhttp3.Callback callback) { 
OkHttpClient client = new OkHttpClient(); 
Request request = new Request.Builder().url(address).build(); 
client.newCall(request).enqueue(callback); 


} 


由 于 OkHttp 的 出 色 封 狼 ， 这 里 和 服务 器 进行 交互 的 代码 非常 简单 ， 仪 仅 
3 行 就 完成 了 。 现 在 我 们 发 起 一 条 HTTP 请 求 只 需要 调 

用 sendokHttpRequest() 方 法 ， 传 入 请 求 地 址 ， 并 注册 一 个 回调 来 处 理 服 
务 器 响应 就 可 以 了 。 


另外 ， 由 于 服务 器 返回 的 省 市 县 数据 都 是 JSON 格 式 的 ， 所 以 我 们 最 好 
再 提供 一 个 工具 类 来 解析 和 处 理 这 种 数据 。 在 util 包 下 新 建 一 个 Utility 
代码 如 下 所 示 : 


public class Utility { 








/xx 
和 和 和 处理 服务 江汉 加 间 台 级 数 


pbuic static boolean handleProvinceResponse(String response) { 

if (!TextUtils.isEmpty(response)) { 
try { 

JSONArray allProvinces = new oN Er OY Cr esp Se 

for (int i = 0; i < allprovinces. length(); i++) { 
JSONObject province0bject = apProvin&es， getJSONObject (i); 
Province province = new Province(); 
province.setProvinceName(provinceObject.getSstring("name")); 
province.setProvinceCode(provinceObject.getInt("id")); 
province.save(); 


return true; 
} catch (JSONException e) { 
e.printSstackTrace(); 


} 


} 
return false; 


/x 
S 和信 辐 用 入 各 二 国有 让 约 


publie static boolean handleCityResponse(String response, int provinceId) { 
if (!TextUtils.isEmpty(response)) { 
try { 


JSONArray allCities = new JSONArray(response) 

for (int i = 0; i < allCities.length(); i++ 
JSONObject cityObject = allCities.getJSONObject(i); 
City city = new City(); 
city.setCityName(cityObject.getString("name")); 
city.setCityCode(cityObject.getInt("id")); 
city.setProvinceId(provinceId ) ; 
city.save(); 


return true; 
} catch (JSONException e) { 
e.printstackTrace(); 


} 


} 
return false; 


} 


/x 
* 解析 和 处 理 服务 器 返回 的 县 级 数据 


public static boolean handleCountyResponse(String response, int cityId) { 

if (!TextUtils.isEmpty(response)) { 
try { 

JSONArray allCounties = new JSONArray(response); 

for (int i = 0; i < allCounties.length(); i++ 
JSONObject countyobject = allCounties.getJSONObject(i); 
County county = new County(); 
county.setCountyName(countyObject.getstring("name")); 
county.setweatherId(countyObject.getstring("weather_id")); 
county.setcityId(cityId); 
county.save(); 


} 
return true; 

} catch (JSONException e) { 
e.printstackTrace(); 


} 


} 
return false; 


可 以 看 到 ， 我 们 提供 了 
handleProvincesResponse()、handleCitiesResponse()、handleCounties 
这 3 个 方法 ， 分 别 用 于 解析 和 处 理 服务 器 返回 的 省 级 、 市 级 和 县 级 数 
据 。 处 理 的 方式 都 是 类 似 的 ， 先 使 用 JSONArray 和 JSONObject 将 数据 解 
析出 来 ， 然 后 组 奢 成 实体 类 对 象 ， 再 调用 save() 方 法 将 数据 存储 到 数据 
库 局 一 由 于 这 里 的 JSON 数 据 结构 比较 简单 ， 我 们 就 不 使 用 GSON 来 进 
行 解析 了 。 


需要 准备 的 工具 类 就 这 么 多 ， 现 在 可 以 开始 写 界 面 了 。 由 于 遍历 全 国 省 
市 县 的 功能 我 们 在 后 面 还 会 复 用 ， 因 此 就 不 写 在 活动 里 面 了 ， 而 是 写 在 
雁 片 里 面 ， 这 样 珊 要 复 用 的 时 候 直 接 在 布局 里 面 引 用 碎片 就 可 以 了 。 


在 res/layout 目 录 中 新 建 choose_area.xml 布 局 ， 代 人 码 如 下 所 示 : 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:background="#fff"> 








<RelativeLayout 
android:layout_width="match_parent" 
android:layout_height="?attr/actionBarSize" 
android:background="?attr/colorPrimary"> 


<TextView 
android:id="@+id/title_ text" 


android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_centerInParent="true" 
android:textColor="#fff" 
android:textSize="20sp"/> 
<Button 
android:id="@+id/back_button" 
android:layout_width="25dp" 
android:layout_height="25dp" 
android:layout_marginLeft="10dp" 
android:layout_alignParentLeft="true" 
android:layout_centerVertical="true" 
android:background="@drawable/ic_back"/> 
</RelativeLayout> 
<ListView 
android:id="@+id/list_view" 
android:layout_width="match_parent" 
android:layout_height="match_parent"/> 


</LinearLayout> 


布局 文件 中 的 内 容 并 不 复杂 ， 我 们 先是 定义 了 一 个 头 布局 来 作为 标题 
兰 ， 将 布局 高 度 设置 为 actionBar 的 高 度 ， 背 景色 设置 为 colorPrimary。 然 
后 在 头 布 局 中 放置 了 一 个 TextView 用 于 显示 标题 内 容 ， 放 置 了 一 个 
Button 用 于 执行 返回 操作 ， 注 意 我 已 经 提前 准备 好 了 一 张 ic_back.png 图 
片 用 于 作为 按钮 的 背景 图 。 这 里 之 所 以 要 自己 定义 标题 柱 ， 是 因为 碎片 
中 最 好 不 要 直接 使 用 ActionBar 或 Toolbar， 不 然 在 复 用 的 时 候 可 能 会 出 
现 一 些 你 不 想 看 到 的 效果 。 


接 下 来 在 头 布局 的 下 面 定 义 了 一 个 ListView， 省 市 县 的 数据 就 将 显示 在 
这 里 。 之 所 以 这 次 使 用 了 ListView， 是 因为 它 会 自动 给 每 个 子 项 之 间 添 
加 一 条 分 隔 线 ， 而 如 果 使 用 RecyclerView 想 实现 同样 的 功能 则 会 比较 麻 
烦 ， 这 里 我 们 总 是 选择 最 优 的 实现 方案 。 


接 下 来 也 是 最 关键 的 一 步 ， 我 们 需要 编写 用 于 遇 有 历 省 市 县 数据 的 碎片 
这 新 建 chooseAreaFragment 继 承 目 Fragment， 代码 如 下 所 示 : 


public class ChooseAreaFragment extends Fragment { 




















public static final int LEVEL_PROVINCE = 0; 
public static final int LEVEL_CITY = 1; 
public static final int LEVEL_COUNTY = 2; 
private ProgressDialog progressDialog; 
private TextView titleText; 

private Button backButton; 

private ListView listView; 

private ArrayAdapter<String> adapter; 


private List<String> dataList = new ArrayList<>(); 
/x* 

* 省 列表 

A 
private List<Province> provincelList; 


/x 
* 市 列表 
Sf 


private List<City> cityList; 


private List<County> countyList; 


/x* 
* 选中 的 省 份 
WW 

private Province selectedProvince; 


yx 
* 选中 的 城市 
二 

private City selectedCity; 





* 当前 选中 的 级 别 
private int currentLevel; 





@override 
public View onCreateView(LayoutInflater inflater, ViewGroup container 
Bundle savedInstanceState) { 
View view inflater.inflate(R.layout.choose area, container, false); 
titleText (TextView) view.findViewById(R.id.title text); 
backButton = (Button) view.findViewById(R.id.back_button); 
listView = (ListView) view.findViewById(R.id.]1list view); 
adapter = new ArrayAdapter<>(getContext(), android.R.]layout.simple_list_ 
item 1, dataList); 
listView.setAdapter(adapter); 
return view; 


} 


@Override 

public void onActivityCreated(Bundle SavedInstanceState) { 
super .onActivityCreated(savedInstanceState); 
listView.setOnItemClickListener(new AdapterView.OnItemClickListener() { 


@Override 
public void onItemClick(AdapterView<?> parent, View view, int position, 
long id) { 


if (currentLevel == LEVEL PROVINCE) { 
selectedProvince = provinceList.get(position); 
queryCities(); 

} else if (currentLevel == LEVEL_CITY) { 
selectedCity = cityList.get(position); 
queryCounties(); 


}); 
backButton.setonCclickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
if (currentLevel == LEVEL COUNTY) { 
queryCities(); 
} else if (currentLevel == LEVEL_CITY) { 
queryProvinces(); 
}); 


queryProvinces(); 


/x* 
* 查询 全 国 所 有 的 省 ， 优 先 从 数据 库 查询 ， 如 果 没 有 查询 到 再 去 服务 器 上 查询 
A 
private void queryProvinces() { 

titleText.setText(" 中 国 "); 
backButton.setVisibility(View.GONE); 
provinceList = DataSupport.findAll(Province.class); 
if (provinceList.size() > 0) { 
dataList.clear(); 
for (Province province : provinceList) { 
dataList.add(province.getProvinceName()); 





adapter .notifyDataSsetChanged(); 
listView.setSelection(0); 
currentLevel = LEVEL_PROVINCE; 

} else { 
String address = "http://guolin.tech/api/china"; 
queryFromServer(address, "province"); 


} 


/x* 
* 查询 选中 省 内 所 有 的 市 ， 优 先 从 数据 库 查询 ， 如 果 没 有 查询 到 再 去 服务 器 上 查询 
private void queryCities() { 
titleText.setText(selectedProvince.getProvinceName()); 
backButton.setVisibility(View.VISIBLE); 
cityList = DataSupport.where("provinceid = ?", String.valueof(selected 
Province.getId())).find(City.class); 
if (cityList.size() > 0) { 
dataList.clear(); 








Tor., {City city :nitytisty-t€ 
dataList.add(city.getCcityName()); 
} 


adapter .notifyDataSetChanged() ; 
listView.setSelection(0); 
currentLevel = LEVEL_CITY; 


} else { 
int provinceCode = selectedProvince.getProvinceCode(); 
String address = "http://guolin.tech/api/china/" + provinceCode; 
queryFromServer(address, "city"); 
} 
/x 


* 查询 选中 市 内 所 有 的 县 ， 优 先 从 数据 库 查询 ， 如 果 没 有 查询 到 再 去 服务 器 上 查询 
A 
private void queryCounties() { 
titleText.setText(selectedCity.getCityName()); 
backButton.setVisibility(View.VISIBLE); 
countyList = DataSupport.where("cityid = ?", String.valueOof(selectedCity. 
getId())).find(County.class); 
if (countyList.size() > 0) 人 
dataList.clear(); 
for (County county : countyList) { 
dataList.add(county.getCcountyName()); 


adapter .notifyDatasetChanged(); 
listView.setSelection(0); 
currentLevel = LEVEL_COUNTY; 

} else { 
int provinceCode = selectedProvince.getProvinceCode(); 
int cityCode = selectedCity.getCityCode(); 


String address = "http://guolin.tech/api/china/" + provinceCode + "/" + 
cityCode; 
queryFromServer(address, "county"); 
} 
} 
/x* 
* 根据 传 入 的 地 址 和 类 型 从 服务 器 上 查询 省 市 县 数据 


private void queryFromServer(String address, final String type) { 
showProgressDialog(); 
HttpUtil.sendOkHttpRequest(address, new Callback() { 


@Override 

public void onResponse(Call call, Response response) throws IOException { 
String responseText = response.body().string(); 
boolean result = false; 


if ("province".equals(type)) { 
result = Utility.handleProvinceResponse(responseText); 
} else if ("city".equals(type)) { 
result = Utility.handleCityResponse(responseText, 
selectedProvince.getId()); 
} else if ("county".equals(type)) { 
result = Utility.handleCountyResponse(responseText, 
selectedcity.getId()); 





} 
if (result) { 
getActivity().runonUiThread(new Runnable() { 
@override 
public void run() { 
closeProgressDialog(); 
if ("province".equals(type)) { 
queryProvinces(); 
} else if ("city".equals(type)) { 
queryCities(); 
} else if ("county".equals(type)) { 
queryCounties(); 
} 





}); 
} 


@Override 
public void onFailure(Call call, IOException e) { 
// 通过 runonUiThread( ) 方 法 回 到 主线 程 处 理 逻 辑 
getActivity().runonUiThread(new Runnable() { 
@Override 
public void run() { 
closeProgressDialog(); 
Toast .makeText(getCcontext(),， "加 载 失 败 "，Toast .LENGTH_SHORT) . 


show( ); 
} 
}); 
} 
}); 
J 
/x 
* 显示 进度 对 话 框 
下 


private void showProgressDialog() { 
if (progressDialog == null) { 
progressDialog = new ProgressDialog(getActivity()); 
progressDialog.setMessage(" 正 在 加 载 ..."); 


progressDialog.setCanceledonTouchOutside(false); 


progressDialog. show(); 


} 

x 
* 关闭 进度 对 话 框 
A 


private void closeProgressDialo 


这 个 类 里 的 代码 虽然 非常 多 ， 可 是 逻辑 却 不 复杂 ， 我 们 来 慢 慢 理 一 下 。 

在 oncreateview() 方 法 中 先是 获取 到 了 一 些 控件 的 实例 ， 然 后 去 初始 化 
了 ArrayAdapter， 并 将 它 设置 为 ListView 的 适配器 。 接 着 

在 onActivitycreated() 方 法 中 给 ListView 和 Button 设 置 了 点 击 事 件 ， 到 
这 里 我 们 的 初始 化 工作 就 算是 完成 了 。 


在 onActivitycreated( ) 方 法 的 最 后 ， 调用 J queryProvinces( 7 也 
就 是 从 这 里 开始 加 载 省 级 数据 的 。queryProvinces() 方 法 中 首先 会 将 头 
布局 的 标题 设置 成 中 国 ， 将 返回 按钮 隐藏 起 来 ， 因 为 省 级 列表 已 经 不 能 
再 返回 了 。 然 后 调用 LitePal 的 查询 接口 来 从 数据 库 中 读 取 省 级 数据 ， 如 
果 读 取 到 了 就 直接 将 数据 显示 到 界面 上 上， 如果 没 有 读 取 到 就 按照 14.1 市 
讲述 的 接口 组 装 出 一 个 请 求 地 址 ， 然 后 调用 queryFromserver() 方 法 来 从 
服务 器 上 查询 数据 。 


queryFromServer( ) 方 法 中 会 调用 HttpUtil 的 sendokHttpRequest( ) 方 法 来 
癌 服务 器 发 送 请 求 ， 啊 应 的 数据 会 回调 到 onResponse() 方 法 中 ， 然 后 我 
们 在 这 里 去 调用 Utility 的 handleProvincesResponse() 方 法 来 解析 和 人 处理 
服务 器 返回 的 数据 ， 并 存储 到 数据 库 中 。 接 下 来 的 一 步 很 关键 ， 在 解析 
和 处 理 完 数据 之 后 ， 我 们 再 次 调用 了 queryProvinces() 方 法 来 重新 加 载 
省 级 数据 ， 由 于 queryProvinces() 方 法 牵扯 到 了 UI 操 作 ， 因 此 必须 要 在 
主线 程 中 调用 ， 这 里 借助 了 runonuiThread() 方 法 来 实现 从 子 线程 切换 到 
主线 程 。 现 在 数据 库 中 已 经 存在 了 数据 ， 因 此 调用 queryProvinces() 束 
会 直接 将 数据 显示 到 界面 上 了 。 


当 你 点 击 了 某 个 省 的 时 候 会 进入 到 ListView 的 onItemclick() 方 法 中 ， 这 
个 时 候 会 根据 当前 的 级 别 来 判断 是 去 调用 querycities() 方 法 还 

是 queryCounties() 方 法 ，querycities() 方 法 是 去 查询 市 级 数据 ， 

而 querycounties() 方 法 是 去 查询 县 级 数据 ， 这 两 个 方法 内 部 的 流程 和 
queryProvinces() 方 法 基本 相同 ， 这 里 就 不 重复 讲解 了 。 
































另外 还 有 一 点 需要 注意 ， 在 返回 按钮 的 点 击 事件 里 ， 会 对 当前 ListView 
的 列表 级 别 进行 判断 。 如 果 当前 是 县 级 列表 ， 那 么 就 返回 到 市 级 列表 ， 
如 果 当 前 是 市 级 列表 ， 那 么 就 返回 到 省 级 表 列 表 。 当 返回 到 省 级 列表 
时 ， 返 回 按钮 会 自动 隐藏 ， 从 而 也 就 不 再 要 再 做 进一步 的 处 理 了 。 


这 样 我 们 就 把 过 历 全 国 省 市 县 的 功能 完成 了 ， 可 是 碎片 是 不 能 直接 显示 
在 界面 上 的 ， 因 此 我 们 还 需要 把 它 添 加 到 活动 里 才 行 。 修 改 
activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<FrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent 
android:layout_height="match_parent"> 








<fragment 
android:id="@+id/choose_area_ fragment" 
android:name="com.coolweather .android.ChooseAreaFragment" 
android:layout_width="match_parent" 
android:layout_height="match_parent" /> 


</FrameLayout> 





布局 文件 很 简单 ， 只 是 定义 了 一 个 FrameLayout， 然 后 将 
ChooseAreaFragment 添 加 进来 ， 并 让 和 它 充满 整个 布局 。 


另外 ， 我 们 刚才 在 碎片 的 布局 里 面 已 经 自 定 义 了 一 个 标题 栏 ， 因 此 束 不 
再 需要 原生 的 ActionBar 了 ， 修 改 res/values/styles.xml 中 的 代码 ， 如 下 所 
外: 


<resources> 


<!-- Base application theme. -- 
<style name="AppTheme" parent= hme, AppCompat .Light.NoActionBar" 


</style> 


</resources> 








现在 第 二 阶段 的 开发 工作 也 完成 得 差不多 了 ， 我 们 可 以 运行 一 下 来 看 看 
效果 。 不 过 在 运行 之 前 还 有 一 件 事 没有 做 ， 那 就 是 声明 程序 所 需要 的 权 
限 。 人 修改 AndroidManifest.xml 中 的 代码 ， 如 下 所 示 : 


<manifest xmlns:android="http : nas android.com/apk/res/android" 
package="com.coolweather .android" 





<uses-permission android:name="android.permission.INTERNET" /> 


</manifest> 


由 于 我 们 是 通过 网 络 接口 来 获取 全 国 省 市 县 数据 的 ， 因 此 必须 要 添加 访 
问 网 络 的 权限 才 行 。 


现在 可 以 运行 一 下 程序 了 ， 结 果 如 图 14.18 所 示 。 











图 14.18 ”显示 省 级 数据 


可 以 看 到 ， 全 国 所 有 省 级 数据 部 显示 出 来 了 。 我 们 还 可 以 继续 查看 市 级 
数据 ， 比 如 后 击 江苏 省 ， 结 果 如 图 14.19 所 示 。 


扬州 








图 14.19 显示 市 级 数据 
这 个 时 候 标 题 栏 上 会 出 现 一 个 返回 按钮 ， 用 于 返回 上 一 级 列表 。 
然后 再 点 击 苏 州 市 查看 县 级 数据 ， 结 果 如 图 14.20 所 示 。 








图 14.20 显示 县 级 数据 
好 了 ， 这 样 第 二 阶段 的 开发 工作 也 都 完成 了 ， 我 们 仍然 要 把 代码 提交 一 
下 。 


commit -m "完成 遍历 省 市 县 三 级 列表 的 功能 。" 
push origin master 


到 目前 为 止 进度 算是 相当 不 错 啊 ， 那 么 我 们 融 趁 热 打 铁 ， 来 进行 第 三 阶 
段 的 开发 工作 。 


14.5 ”显示 天 和气 信息 


在 第 三 阶段 中 ， 我 们 就 要 开始 去 查询 天 气 ， 并 且 把 天 气 信息 显示 出 来 
了 。 由 于 和 风 天 气 返 回 的 JSON 数 据 结构 非常 复杂 ， 如 果 还 使 用 
JSONObject 来 解析 就 会 很 抹 烦 ， 这 里 我 们 就 准备 借助 GSON 来 对 天 气 信 
恩 进 行 解析 了 。 

14.5.1 ”定义 GSON 实 体 类 

GSON 的 用 法 很 简单 ， 解 析 数 据 只 需要 一 行 代码 就 能 完成 了 ， 但 前 提 是 
要 先 将 数据 对 应 的 实体 类 创建 好 。 由 于 和 风 天 气 返 回 的 数据 内 容 非常 
多 ， 这 里 我 们 不 可 能 将 所 有 的 内 容 都 利用 起 来 ， 因 此 我 生 选 了 一 些 比 较 
重要 的 数据 来 进行 解析 。 

首先 我 们 回顾 一 下 返回 数据 的 大 致 格式 : 














其 中 ，basic、aqi、now、suggestion 和 daily_forecast 的 内 部 又 都 会 有 
具体 的 内 容 ， 那 么 我 们 就 可 以 将 这 5 个 部 分 定义 成 5 个 实体 类 。 


下 面 开始 来 一 个 个 看 ，basic 中 具体 内 容 如 下 所 示 : 





asic":{ 
"city": "苏州 
"id":"CN101190401", 
"update": 
"loc":"2016-08-08 21:58" 
} 
} 


其 中 ，city 表 示 城 市 名 ，id 表 示 城 市 对 应 的 天 气 id，update 中 的 loc 表 示 
天 气 的 更 新 时 间 。 我 们 按照 此 结构 就 可 以 在 gson 包 下 建立 一 个 Basic 


类 ， 代 码 如 下 所 示 : 


public class Basic { 


Q@SerializedName("city") 
public String cityName 


@serializedName("id") 
public String weatherId; 


public Update update; 
public class Update { 


@serializedName("loc") 
public String updateTime; 


由 于 JSON 中 的 一 些 字 段 可 能 不 太 适 合 直 接 作为 Java 字 上 段 来 命名 ， 因 此 这 
里 使 用 了 @SerializedName 注 解 的 方式 来 让 JSON 字 段 和 Java 字 段 之 间 建 
并 映射 关系 。 


这 样 我 们 就 将 Basic 类 定义 好 了 ， 还 是 挺 容易 理解 的 吧 ? 其 余 的 几 个 实 
体 类 也 是 类 似 的 ， 我 们 使 用 同样 的 方式 来 定义 就 可 以 了 。 比 如 aqi 中 的 
具体 内 容 如 下 如 示 : 





aqi":{ 
"ofty "sk 
"aqi": "44", 
"pm25": "13" 
了 
} 


那么 ， 在 gson 包 下 新 建 一 个 AQI 类 ， 代 码 如 下 所 示 : 


public class AQI { 
public AQICity city; 
public class AQICity { 
public String aqi; 


public String pm25; 


now 中 的 具体 内 容 如 下 所 示 : 


"now":{ 
"tmp":"29", 
"cond":{ 
"txt": "阵雨" 





那么 ， 在 gson 包 下 新 建 一 个 Now 类 ， 代 码 如 下 所 示 : 


public class Now { 


@serializedName("tmp") 
public String temperature; 


@serializedName("cond") 
public More more; 


public class More { 


@serializedName("txt") 
public String info; 


suggestion 中 的 具体 内 容 如 下 所 示 : 


"suggestion":{ 
"comf":{ 
"txt":" 白 天 天 气 较 热 ， 虽 然 有 雨 ， 但 仍然 无 法 前 弱 较 高 气温 给 人 们 带 来 的 暑 意 
这 种 天 气 会 让 您 感到 不 很 舒适 。" 

















a 
"txt": "不 宜 洗 车， 未 来 24 小 时 内 有 十 ， 如 果 在 此 期 间 洗 车 ， 雨 水 和 路 上 的 泥水 
可 能 会 再 次 弄 脏 您 的 爱 车 。" 

















}, 
"sport":{ 
"txt":" 有 降水 ， 且 风力 较 强 ， 推 荐 您 在 室内 进行 低 强度 运动 ， 若 坚持 户外 运动 ， 
请 选择 避 雨 防风 的 地 点 。" 
} 


} 


那么 ， 在 gson 包 下 新 建 一 个 suggestion 类 ， 代 人 码 如 下 所 示 : 


public class Suggestion { 


@serializedName("comf") 
public Comfort comfort; 


@serializedName("cw") 
public Carwash carwash; 


public Sport sport; 
public class Comfort { 


Q@SerializedName("txt") 
public String info; 


} 
public class Carwash { 


@serializedName("txt") 
public String info; 


} 
public class Sport { 


@serializedName("txt") 
public String info; 


到 目前 为 止 都 还 比较 简单 ， 不 过 接 下 来 的 一 项 数据 就 有 点 特殊 


了 ，daily_ forecast 中 的 具体 内 容 如 下 所 示 : 


"daily_forecast":[ 
{ 


"date":"2016-08-08", 





cond 
"txt_d": "阵雨" 
tmp":{ 
"max":"34 
"mln "a7 
} 
}, 
{ 
"date":"2016-08-09", 
cond 
"etd : 多云 " 
tmp":{ 
"max":"35 
"min":"29 
} 


可 以 看 到 ，daily_forecast 中 包含 的 是 一 个 数组 ， 数 组 中 的 每 一 项 都 代 
表 着 未 来 一 天 的 天 气 信息 。 针 对 于 这 种 情况 ， 我 们 只 需要 定义 出 单 日 天 
气 的 实体 类 就 可 以 了 ， 然 后 在 声明 实体 类 引用 的 时 候 使 用 集合 类 型 来 进 
行 声 明 。 


那么 在 gson 包 下 新 建 一 个 Forecast 类 ， 代 码 如 下 所 示 : 


public class Forecast { 











public String date; 


@serializedName("tmp") 
public Temperature temperature; 


@serializedName("cond") 
public More more; 


public class Temperature { 
public String max; 
public String min; 

} 

public class More { 


@serializedName("txt_d") 
public String info; 


这 样 我 们 就 把 pasic、aqi、now、 ge Onde yt ocecast I 
体 类 全 部 都 创建 好 了 ， 接 下 来 还 需要 再 创建 一 个 总 的 实例 类 来 引用 刚刚 
创建 的 各 个 实体 类 ， 征 ggon 包 下 新 建 一 个 Weather 类 ， 代 码 如 下 所 示 : 


public class Weather { 








public String status; 


public Basic basic; 

public AQI aqi; 

public Now now; 

public Suggestion suggestion; 


@serializedName("daily_forecast") 
public List<Forecast> forecastList; 


在 weather 关 中 ， 我 们 对 Basic、 AQI、 Now、 suggestion 和 Forecast 类 进 

行 了 引用 。 其 中 ， 由 于 daily_forecast 中 包含 的 是 一 个 数组 ， 因 此 这 里 
使 用 了 Li 集合 来 引用 Forec st 闫 。 男 外 ， 返 回 的 天 气 数 据 中 还 会 包含 
一 项 status 数 据 ， 成 功 返 回 ok， 失败 则 会 返 回 具体 的 原因 ， 那 么 这 里 也 
需要 添加 一 个 对 应 的 status 字 段 。 


现在 所 有 的 GSON 实 体 类 都 定义 好 了 ， 接 下 来 我 们 开始 编写 天 气 界 面 。 
14.5.2 ”编写 天 和 气 界 面 


首先 创建 一 个 用 于 显示 天 气 信息 的 活动 。 右 击 com.coolweather.android 包 
-New Activity -Empty Activity， 创 建 一 个 weatherActivity， 并 将 布局 
名 指定 成 activity_weather.xml。 


由 于 所 有 的 天 怀 信息 部 将 在 同一 个 界面 上 显示 ， 因此 
activity_weather.xml 会 是 一 个 很 长 的 布局 文件 。 那 么 为 了 让 里 面 的 代码 
不 至 于 混乱 不 堪 ， 这 里 我 准备 使 用 3.4.1 小 节 学 过 的 引入 布局 技术 ， 即 将 
界面 的 不 同 部 分 写 在 不 同 的 布局 文件 里 面 ， 0 
至 jactivity_weather.xml 中 ， 这 样 整 个 布局 文件 束 会 显得 非常 工整 。 


右 击 res/layout New -Layout resource file， 新 建 一 个 title.xml 作 为 头 布 
局 ， 代 码 如 下 所 示 : 


<RelativeLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="?attr/actionBarSize"> 























<TextView 
android:id="@+id/title_city" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_centerInParent="true" 
android:textColor="#fff" 
android:textSize="20sp" /> 


<TextView 
android:id="@+id/title update time" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_marginRight="10dp" 
android:layout_alignParentRight="true" 
android:layout_centerVertical="true" 
android:textColor="#fff" 


android : 


textSize="16sp"/> 


</RelativeLayout> 


这 段 代 码 还 是 比较 简单 的 ， 头 布局 中 放置 了 两 个 TextView， 一 个 居中 显 





示 城 市 名 ， 


然后 新 建 一 个 now.xml 作 为 当 


<LinearLayout 


-个 居 右 显示 更 新 时 间 。 








前 天 气 信 


言 轧 的 布局 ， 代 码 如 下 所 未 : 


xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:layout_margin="15dp"> 


<TextView 


android: 
android: 
android: 
android: 
android: 
android: 


<TextView 
android 


android 
android 


</LinearLayout> 


id="@+id/degree_text" 
layout_width="wrap_content" 
layout_height="wrap_content" 
layout_gravity="end" 
textColor="#fff" 
textSize="60sp" /> 


:id="@+id/weather_info_text" 
android: 


layout_width="wrap_content" 


:layout_height="wrap_content" 
:layout_gravity="end" 

android: 
android: 


textColor="#fff" 
textSize="20sp" /> 








ER 





当前 天 气 信息 的 布局 中 也 是 放置 了 两 个 TextView， 一 个 用 于 显示 当 


A 


昌 ， 一 个 用 于 显示 天 气概 况 。 











用 


然后 新 建 forecast.xzml 作 为 未 来 几 天 天 气 信息 的 布局 ， 代 码 如 下 所 示 : 


<LinearLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:layout_margin="15dp" 
android:background="#8000"> 


<TextView 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_marginLeft="15dp" 
android:layout_marginTop="15dp" 
android:text=" 预 报 " 
android:textColor="#fff" 
android:textSize="20sp"/> 

<LinearLayout 
android:id="@+id/forecast_layout" 
android:orientation="vertical" 
android:layout_width="match_parent" 


android:layout_height="wrap_content"> 


</LinearLayout> 


</LinearLayout> 


这 里 最 外 层 使 用 LinearLayout 定 义 了 一 个 半 透 明 的 背景 ， 然 后 使 用 


\ 


TextView 定 义 了 一 个 标题 ， 接 着 又 使 用 一 个 LinearLayout 定 DA | 
ee 不 过 这 个 布局 中 并 没有 放 入 任何 内 
是 要 根据 服务 器 返回 的 数据 在 代码 中 动态 添加 的 。 


， 因 为 这 


为 此 ， 我 们 还 需要 




















再 定义 


forecast_item.xml 文 件 ， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:layout_margin="15dp"> 


<TextView 


android: 
android: 
android: 
android: 
android: 
android: 


<TextView 


android: 
:layout_width="Qdp" 

:layout_height="wrap_content" 
android: 
android: 


android 
android 


android 


<TextView 


android: 
android: 
android: 
android: 
android: 
android: 
android: 


<TextView 
android 
android 


android 


android 
android 


</LinearLayout> 


子 项 布局 中 放置 了 4 个 TextView， 
于 显示 天 气概 况 ， 另 外 两 个 分 别 用 于 显示 


然后 新 建 aqi.xml 作 为 空 


<LinearLayout 


id="@+id/date_text" 
layout_width="Qdp" 
layout_height="wrap_content" 
layout_gravity="center_vertical" 
layout_ weight="2" 
textColor="#fff"/> 


id="@+id/info_text" 


layout_gravity="center_vertical" 
layout_ weight="1" 





:gravity="center" 
android: 


textColor="#fff"/> 


id="@+id/max_text" 
layout_width="Qdp" 
layout_height="wrap_content" 
layout_gravity="center" 
layout_ weight="1" 
gravity="right" 
textColor="#fff"/> 


:id="@+id/min_text" 
:layout_width="Qdp" 
android: 


layout_height="wrap_content" 


:layout_gravity="center" 
:layout_weight="1" 

:gravity="right 
android: 





textColor="#fff"/> 





个 用 于 显示 天 和 气 


-个 未 来 天 气 信息 的 子 项 布局 ， 创 建 


预报 日 期 ， 一 个 用 

















xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:layout_margin="15dp" 
android:background="#8000"> 


<TextView 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_marginLeft="15dp" 
android:layout_marginTop="15dp" 
android:text=" 空 气质 量 " 
android:textColor="#fff" 
android:textSize="20sp"/> 

<LinearLayout 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 


当天 的 最 高 温 
气质 量 信 息 的 布局 ， 代 码 如 下 所 示 : 


度 和 最 低温 度 。 


android:layout_margin="15dp"> 


<RelativeLayout 
android:layout_width="Qdp" 
android:layout_height="match_parent" 
android:layout weight="1"> 


<LinearLayout 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:layout_centerInParent="true"> 


<TextView 
android:id="@+id/aqi_text" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center" 
android:textColor="#fff" 
android:textSize="40sp" 
/> 


<TextView 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center" 
android:text="AQI 指 数 " 
android:textColor="#fff"/> 


</LinearLayout> 
</RelativeLayout> 


<RelativeLayout 
android:layout_width="Qdp" 
android:layout_height="match_parent" 
android:layout_ weight="1"> 


<LinearLayout 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:layout_centerInParent="true"> 


<TextView 
android:id="@+id/pm25_text" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center" 
android:textColor="#fff" 
android:textSize="40sp" 
/> 


<TextView 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center" 
android:text="PM2.5 指 数 " 
android:textColor="#fff" 
/> 


</LinearLayout> 
</RelativeLayout> 
</LinearLayout> 


</LinearLayout> 








这 个 布局 中 的 代码 虽然 看 上 去 有 点 长 ， 但 是 并 不 复杂 。 首 先前 面 都 是 一 
样 的 ， 使 用 LinearLayout 定 义 了 一 个 半 透 明 的 背景 ， 然 后 使 用 TextView 
定义 了 一 个 标题 。 接 下 来 ， 这 里 使 用 LinearL yOu RelativeLayout 欧 套 
的 方式 实现 了 一 个 左右 平分 并 且 居 中 对 齐 的 布局 ， 分 别 用 于 显示 AQI 指 
数 和 PM 2.5 指 数 。 相 信 你 只 要 仔细 看 一 看 ， 这 个 布局 还 是 很 好 理解 的 。 


然后 新 建 suggestion.xml 作 为 生活 建议 信息 的 布局 ， 代 码 如 下 所 示 : 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 








android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:layout_margin="15dp" 
android:background="#8000"> 


<TextView 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_marginLeft="15dp" 
android:layout_marginTop="15dp" 
android:text=" 生 活 建议 " 
android:textColor="#fff" 
android:textSize="20sp"/> 





<TextView 
android:id="@+id/comfort_text" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_margin="15dp" 
android:textColor="#fff" /> 


<TextView 
android:id="@+id/car_wash_text" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_margin="15dp" 
android:textColor="#fff" /> 


<TextView 
android:id="@+id/sport_text" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_margin="15dp" 
android:textColor="#fff" /> 





</LinearLayout> 


这 里 同样 也 是 先 定 义 了 一 个 半 透 明 的 背景 和 一 个 标题 ， 然 后 下 面 使 用 了 
3 个 TextView 分 别 用 于 显示 和 舒适 度 、 洗 车 指数 和 运动 建议 的 相关 数据 。 


这 样 我 们 就 把 天 气 界面 上 每 个 部 分 的 布局 文件 都 编写 好 了 ， 接 下 来 的 工 
作 就 是 将 它们 引入 到 activity_weather.xml 当 中 ， 如 下 上 所 示 : 


<FrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:background="@color/colorPrimary"> 








<ScrollView 
android:id="@+id/weather_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:scrollbars="none" 
android:overscrollMode="never"> 
<LinearLayout 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="wrap_content"> 
<include layout="@layout/title" /> 
<include layout="@layout/now" /> 
<include layout="@layout/forecast" /> 
<include layout="@layout/aqi" /> 
<include layout="@layout/suggestion" /> 
</LinearLayout> 


</ScrollView> 


</FrameLayout> 





可 以 看 到 ， 首 先 最 外 层 布 局 使 用 了 一 个 FrameLayout， 并 将 它 的 背景 
设置 成 colorPrimary。 然 后 在 FrameLayout 中 航 套 了 一 个 ScrollView， 这 
是 因为 天 气 界 面 中 的 内 容 比 较 多 ， 使 用 ScrollView 可 以 允许 我 们 通过 滚 
动 的 方式 碍 看 屏幕 以 外 的 内 容 。 

由 于 ScrollView 的 内 部 只 允许 存在 一 个 直接 子 布局 ， 因 此 这 里 又 艇 套 了 
一 个 垂直 方向 的 LinearLayout， 然 后 在 LinearLayout 中 将 刚才 定义 的 所 有 
布局 逐个 引入 。 


这 样 我 们 束 将 天 气 界面 编写 完成 了 ， 接 下 来 开始 编写 业务 逻辑 ， 将 天 气 
显示 到 界面 上 。 


14.5.3 ”将 天 气 显 示 到 界面 上 


需要 在 Utility 类 中 添加 一 个 用 于 解析 天 气 JSON 数 据 的 方法 ， 如 下 
小 : 


public class Utility { 








/** 
* 将 返回 的 JSON 数 据 解析 成 Weather 实 体 类 
Ss 
public static Weather handleweatherResponse(String response) { 
try { 


JSONObject jsonObject = new JSONObject(response); 
JSONArray jsonArray = jsonObject.getJSONArray("Heweather"); 
String weatherContent = jsonArray.getJSONObject(0).tostring(); 
return new Gson().fromJson(weatherCcontent, Weather.class); 

} catch (Exception e) { 
e.printstackTrace(); 


} 
return null; 





可 以 看 到 ， handleweatherResponse( ) 方 法 中 先是 通过 JsoNobj ect 和 
JSONArray 将 天 气 数据 中 的 主体 内 容 解 析出 来 ， 即 如 下 内 容 : 


{ 


"status": "ok" 





"suggestion": {}, 
"daily_forecast": [] 








然后 由 于 我 们 之 前 已 经 按照 上 面 的 数据 格式 定义 过 相应 的 GSON 实 体 
类 ， 因 此 只 需要 通过 调用 fromJson() 方 法 就 能 直接 将 JSON 数 据 转 换 


成 Weather 对 象 了 。 


接 下 来 的 工作 是 我 们 如 何在 活动 中 去 请 求 天 气 数据 ， 以 及 将 数据 展示 到 
界面 上 上。 修改 WeatherActivity 中 的 代码 ， 如 下 所 示 : 


public class WeatherActivity extends AppCompatActivity { 








private ScrollView weatherLayout; 
private TextView titleCity; 
private TextView titleUpdateTime; 
private TextView degreeText; 
private TextView weatherInfoText 
private LinearLayout forecastLayout ; 
private TextView aqiText; 

private TextView pm25Text; 
private TextView comfortText; 
private TextView carwashText; 
private TextView SportText 


@override 
protected void onCreate(Bundle SavedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity_ weather); 
// 初始 化 各 控件 
weatherLayout = (ScrollView) findViewById(R.id.weather_layout); 
titleCity = (TextView) findViewById(R.id.title city); 
titleUpdateTime = (TextView) findViewById(R.id.title update time); 
degreeText = (TextView) findViewById(R.id.degree text); 
weatherInfoText = (TextView) findViewById(R.id.weather_info_ text); 
forecastLayout = (LinearLayout) findViewById(R.id.forecast_layout); 
aqiText = (TextView) findViewById(R.id.aqi text); 
pm25Text = (TextView) findViewById(R.id.pm25_text); 
comfortText = (TextView) findViewById(R.id.comfort_text); 
carwashText = (TextView) findViewById(R.id.car_wash_text); 
SportText = (TextView) findViewById(R.id.sport text); 
SharedPreferences prefs = PreferenceManager .getDefaultSharedPreferences 
(this) 
String weatherString = prefs.getString("weather"，nul1) 
if (weatherString != null) { 
// 有 缓存 时 直接 解析 天 气 数据 
Weather weather = Utility.handleweatherResponse(weatherString ) ， 
ShowweatherInfo(weather ) ; 
} else { 
// 无 缓存 时 去 服务 器 查询 天 气 
String weatherId = getIntent().getStringExtra("weather_id") 
weatherLayout.setVisibility(View.INVISIBLE); 
requestweather (weatherId); 


} 


yx 
* 根据 天 气 id 请 求 城市 天 气 信 息 
天 

public void requestweather(final String weatherId) { 


String weatherUrl = "http://guolin.tech/api/weather?cityid=" + 
weatherId + "&key=bc0418b57b2d4918819d3974ac1285d9"，; 
HttpUtil.sendOkHttpRequest(weatherUrl, new Callback() { 
@Override 
public void onResponse(Call call, Response response) throws IOException { 
final String responseText = response.body().string(); 
final Weather weather = Utility.handleweatherResponse(responseText); 
runonUiThread(new Runnable() { 
@Override 
public void run() { 
if (weather != null && "ok".equals(weather.status)) { 
SharedPreferences.Editor editor = PreferenceManager. 
getDefaultSharedPreferences(WeatherActivity.this). 
edit(); 
editor.putSstring("weather", responseText); 
editor.apply(); 
ShowweatherInfo(weather ); 
} else { 
Toast .makeText (WeatherActivity.this, "获取 天 气 信息 失败 "， 
Toast .LENGTH_SHORT) .show( ); 





}); 


} 


@override 
public void onFailure(Call call, IOException e) { 
e.printSstackTrace(); 
runonUiThread(new Runnable() { 
@Override 
public void run() { 
Toast.makeText (WeatherActivity.this, "获取 天 气 信息 失败 "， 
Toast .LENGTH_SHORT) .show(); 





* 处 理 并 展示 Weather 实 体 类 中 的 数据 
Tk 


private void showweatherInfo(Weather weather) { 
String cityName = weather.basic.cityName; 
String updateTime = weather.basic.update. es Splig(t” I] 
String degree = weather .now.temperature + "'C" 
String weatherInfo = weather .now.more.info; 
titleCity.setText(cityName); 
titleUpdateTime.setText(updateTime); 





degreeText.setText(degree); 

weatherInfoText.setText(weatherInfo); 

forecastLayout.removeAllViews(); 

for (Forecast forecast : weather .forecastList) 
View view = LayoutInflater.from(this).inflate(R.layout.forecast_ 

item, forecastLayout, false); 

TextView dateText = (TextView) view.findViewById(R.id.date text); 
TextView infoText = (TextView) view.findViewById(R.id.info_ text); 
TextView maxText = (TextView) view.findViewById(R.id.max_text); 
TextView minText = (TextView) view.findViewById(R.id.min_ text); 
dateText.setText(forecast.date); 
infoText.setText(forecast.more.info); 





maxText.setText(forecast.temperature.max); 
minText.setText(forecast.temperature.min); 
forecastLayout.addView(view); 





} 

if (weather.aqi != null) 
aqiText.setText (weather.aqi.city.aqi); 
pm25Text .setText (weather .aqi.city.pm25); 


String comfort = "舒适 度 : " + weather.suggestion.comfort.info; 
String carwash = "洗车 指数 : " + weather.suggestion.carWash.info; 
String sport = "运动 建议 : " + weather.suggestion.sport.info' 


comfortText.setText(comfort); 
carwashText.setText(carwash); 
sportText.setText(sport); 
weatherLayout.setVisibility(View.VISIBLE); 


这 个 活动 中 的 代码 也 比较 长 ， 我 们 还 是 一 步 步 梳 理 下 。 在 oncreate() 方 
法 中 仍然 先 是 去 区 取 一 些 控件 的 人 然后 会 尝试 从 本 地 缓存 中 读 取 天 
气 数据 。 那 么 第 肯定 是 没有 缓存 的 ， 因 此 就 会 从 Intent 中 取出 天 气 
id， 痢 有 requesuueatner0 方 来 从 服务 叶 水 关 气 注意 ， 请 
ee 候 先 将 ScrollView 进 行 隐藏 ， 不 然 空 数 据 的 界面 看 上 去 会 很 
可 性。 


requestweather() 方 法 中 先是 使 用 了 参数 中 传 入 的 天 气 id 和 我 们 之 前 申 
请 好 的 API Key 拼 装 出 一 个 接口 地 址 ， 接 着 调 
用 Httputil. a i 服务 器 会 
将 相应 城市 的 天 气 信 息 以 JSON 格 式 返 回 。 然 后 我 们 在 onResponse() 回 调 
中 先 调用 utility， ) 方 法 将 返回 的 JSON 数 据 转 
换 成 weather 对 象 ， 再 将 当前 线程 切换 到 主线 程 。 然 后 进行 判断 ， 如 果 

















服务 器 返回 的 status 状 态 是 ok， 束 说 明 请 求 天 气 成 功 了 ， 此 时 将 返回 的 
数据 缓存 到 SharedPreferences 当 中 ， 并 调用 showweatherInfo() 方 法 来 进 
行内 容 显示 。 


showweatherInfo() 方 法 中 的 逻辑 束 比 较 简 单 了 ， 其 实 就 是 从 weather 对 
象 中 获取 数据 ， 然 后 显示 到 相应 的 控件 上 。 注 意 在 未 来 几 天 天 气 预 报 的 
部 分 我 们 使 用 了 一 个 for 循 环 来 处 理 每 天 的 天 气 信 息 ， 在 循环 中 动态 加 载 
forecast_item.xml 布 局 并 设置 相应 的 数据 ， 然 后 添加 到 父 布局 当中 。 设 
置 完 了 所 有 数据 之 后 ， 记 得 要 将 ScrollView 重 新 变 成 可 见 。 








这 样 我 们 就 将 首次 进入 WeatherActivity 时 的 逻辑 全 部 梳理 完了 ， 那 么 当 
下 一 次 再 进入 WeatherActivity 时 ， 由 于 缓存 已 经 存在 了 ， 因 此 会 直接 解 
析 并 显示 天 气 数 据 ， 而 不 会 再 次 发 起 网 络 请 求 了 。 








处 理 完了 WeatherActivity 中 的 逻辑 ， 接 下 来 我 们 要 做 的 ， 就 是 如 何 从 省 
市 县 列表 界面 跳 转 到 天 和气 界面 了 ， 人 和 修改 ChooseAreaFragment 中 的 代码 ， 
如 下 所 示 : 


public class ChooseAreaFragment extends Fragment { 


@Ooverride 
public void onActivityCreated(Bundle savedInstanceState) { 
super .onActivityCreated(savedInstanceState); 
listView.setOnItemClickListener(new AdapterView.OnItemClickListener() { 
@Override 
public void onItemClick(AdapterView<?> parent, View view, int position, 
long id) { 
if (currentLevel == LEVEL_PROVINCE) 
selectedProvince = provinceList.get(position); 
queryCities(); 
} else if (currentLevel == LEVEL_CITY) { 
selectedCity = cityList.get(position); 
queryCounties(); 
} else if (currentLevel == LEVEL COUNTY) { 
String weatherId = countyList.get(position).getweatherId(); 


Intent intent = new Intent(getActivity(), WeatherActivity. 
class); 


intent.putExtra("weather_id", weatherId); 
startActivity(intent); 
getActivity().finish(); 


非常 简单 ， 这 里 在 onItemclick() 方 法 中 加 入 了 一 个 if 判 断 ， 如 果 当 前 级 
别 是 LEVEL_COUNTY， 就 启动 WeatherActivity， 并 把 当前 选中 县 的 天 气 id 传 


另外 ， 我 们 还 需要 在 MainActivity 中 加 入 一 个 缓存 数据 的 判断 才 行 。 修 


改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
@override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity main); 
SharedPreferences prefs = PreferenceManager .getDefau1ltSharedPreferences 
is); 
if (prefs.getSstring("weather", null) != null) { 
Intent intent = new Intent(this, WeatherActivity.class); 
startActivity(intent); 
finish(); 


可 以 看 到 ， 这 里 在 oncreate( ) 方 法 的 一 开始 先 从 SharedPreferences 文 件 
中 读 取 缓存 数据 ， 如 果 不 为 null 束 说 明之 前 已 经 请 求 过 天 气 数据 了 ， 那 
么 就 没 必 要 让 用 户 再 次 选择 城市 ， 而 是 直接 跳 转 到 WeatherActivity 即 
可 。 


好 了 ， 现 在 重新 运行 一 下 程序 ， 然 后 选择 江苏 ”苏州 = 昆山， 结果 如 图 
14.21 所 示 。 
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图 14.21 显示 天 气 信 息 


然后 我 们 还 可 以 向 下 滑动 查看 更 多 天 气 信息 ， 如 图 14.22 所 示 。 
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生活 建议 


知 适 度 ; 白天 天 气 隧 好 ， 明 姻 的 阳光 在 给 您 带 来 好 心 
的 同时 ， 也 会 使 您 感到 有 些 热 ， 不 很 舒适 . 


洗车 指数 ; 较 不 宜 洗 车 ， 未 来 一 天 无 雨 ， 风 力 较 大 ， 如 
果 执 总 擦洗 汽车 ， 要 做 好 菜 上 污垢 的 心理 准备 。 


运动 建议 : 天 气 较 好 ， 但 由 于 风力 较 大 ， 推 荐 您 在 室内 
进行 低 强度 运动 ， 若 在 户外 运动 请 注意 避风 。 
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图 14.22 ”查看 更 多 天 气 信息 
14.5.4 获取 必 应 每 日 一 图 


虽说 现在 我 们 已 经 把 天 气 界 面 编写 得 非常 不 错 了 ， 不 过 和 市 场 上 的 一 些 
天 气 软件 的 界面 相 比 ， 仍 然 还 是 有 一 定 差距 的 。 出 色 的 天 气 软件 不 会 像 
我 们 现在 这 样 使 用 一 个 固定 的 背景 色 ， 而 是 会 根据 不 同 的 城市 或 者 天 气 
情况 展示 不 同 的 背景 图 片 。 


当然 实现 这 个 功能 并 不 复杂 ， 最 重要 的 是 需要 有 服务 器 的 接口 文 持 。 不 
过 我 实在 是 没有 精力 去 准备 这 样 一 套 完善 的 服务 顺 接 口 ， 那 么 为 了 不 让 
我 们 的 天 气 界 面 过 于 单调 ， 这 里 我 准备 使 用 一 个 巧妙 的 办 法 。 

















必 应 想必 你 肯定 不 会 陌生 ， 这 是 一 个 由 微软 开发 的 搜索 引擎 网 站 。 这 个 
网 站 除了 提供 强大 的 搜索 功能 之 外 ， 还 有 一 个 非常 有 特色 的 地 方 ， 就 是 
它 每 天 部 会 在 上 页 展示 一 张 精 美的 背景 图 片 ， 如 图 14.23 所 示 。 








图 14.23” 必 应 的 首页 
由 于 这 些 图 片 都 是 由 必 应 精 挑 细 选 出 来 的 ， 并 且 每 天 都 会 变化 ， 如 果 我 





们 使 用 它们 来 作为 天 气 界 面 的 背景 图 ， 不 仅 可 以 让 界面 变 得 更 加 美观 ， 
而 且 解 决 了 界面 一 成 不 变 、 过 于 单调 的 问题 。 


为 此 我 专门 准备 了 一 个 获取 必 应 每 日 一 图 的 接 
口 : http://guolin.tech/api/bing pic。 


访问 这 个 接口 ， 服 务 费 会 返回 今日 的 必 应 背景 图 链接 : 





http://cn.bing.com/az/hprichbg/rb/ChicagoHarborLH ZH- 
CN9974330969 1920x1080.jpg。 


然后 我 们 再 使 用 Glide 去 加 载 这 张 图 片 就 可 以 了 。 


总 体 思路 就 是 这 么 简单 ， 下 面 开 始 来 动手 实现 吧 。 首 先 修改 
activity_weather.xml 中 的 代码 ， 如 下 所 示 : 


<FrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:background="@color/colorPrimary"> 


<ImageView 
android:id="@+id/bing_pic_img" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:scaleType="centerCrop" /> 


<ScrollView 
android:id="@+id/weather_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:scrollbars="none" 
android:overscrollMode="never"> 


</ScrollView> 


</FrameLayout> 


这 里 我 们 在 FrameLayout 中 添加 了 一 个 ImageView， 并 且 将 它 的 宽 和 高 都 
设置 成 match_parent。 由 于 FrameLayout 默 认 情 况 下 会 将 控件 都 放置 在 左 
上 角 ， 因 此 ScrollView 会 完全 和 窗 新 住 ImageView， 从 而 ImageView 也 就 成 
为 背景 图 片 了 。 


接着 修改 WeatherActivity 中 的 代码 ， 如 下 所 示 : 


public class WeatherActivity extends AppCompatActivity { 


private ImageView bingPicImg; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
setContentView(R.1layout.activity _ weather); 
// 初始 化 各 控件 
bingPicImg = (ImageView) findViewById(R.id.bing_ pic_img); 


String bingPic = prefs.getSstring("bing_pic", null); 
if (bingPic != null) { 
Glide.with(this).load(bingPic).into(bingPicImg); 
} else { 
loadBingPic(); 
了 


} 


/x 
* 根据 天 气 id 请 求 城市 天 气 信息 
public void requestweather(final String weatherId) { 


loadBingpic(); 
} 


/x* 
* 加 载 必 应 每 日 一 图 
private void loadBingPic() { 
String requestBingPic = "http://guolin.tech/api/bing_pic"; 
HttpUtil.sendOkHttpRequest(requestBingPic, new Callback() { 
@Override 
public void onResponse(Call call, Response response) throws IOException { 
final String bingPic = response.body().string(); 
SharedPreferences.Editor editor = PreferenceManager. 
getDefaultSharedPreferences(WeatherActivity.this).edit(); 
editor.putSstring("bing_pic", bingPic); 
editor.apply(); 
runonUiThread(new Runnable() { 
@Override 
public void run() { 
Glide.with(WeatherActivity.this).1load(bingPic).into 
(bingPicImg); 


}); 


} 

Override 

public void onFailure(Call call, IOException e) { 
.printstackTrace(); 

} 


}); 
} 





可 以 看 到 ， 首 先 在 oncreate() 方 法 中 获取 了 新 增 控件 ImageView 的 实 
例 ， 然 后 党 试 从 SharedPreferences 中 读 取 缓存 的 背景 图 片 。 如 果 有 组 存 
的 话 就 直接 使 用 Glide 来 加 载 这 张 图 片 ， 如 果 没 有 的 话 就 调 

用 loadBingPic() 方 法 去 请 求 今日 的 必 应 背景 图 。 


loadBingPic( ) 方 法 中 的 逻辑 就 非常 简单 了 ， 先 是 调用 了 
HttpUtil.sendokHttpRequest() 方 法 获取 到 必 应 背景 图 的 链接 ， 然 后 将 
这 个 链接 缓存 到 SharedPreferences 当 中 ， 再 将 当前 线程 切换 到 主线 程 ， 

最 后 使 用 Glide 来 加 载 这 张 图 片 就 可 以 了 。 男 外 需要 注意 ， 

在 requestweather( 六 法 的 最 后 也 需要 调用 一 下 loadBingPic( ) 方 法 ， 这 
样 在 每 次 请 求 天 气 信 息 的 时 候 同 时 也 会 刷新 背景 图 片 。 现 在 重新 运行 一 
下 程序 ， 效 果 如 图 14.24 所 示 。 
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图 14.24 在 天 气 界 面 显示 必 应 背景 图 


怎么 样 ? 虽说 只 是 换 了 一 张 背 景 图 而 已 ， 但 是 整个 界面 的 视觉 体验 就 完 
全 不 一 样 了 ， 有 瞬间 提升 了 好 几 个 档次 。 而 且 我 们 的 背景 图 并 不 是 一 成 不 
变 的 ， 每 天 都 会 是 不 同 的 图 片 ， 永 远 给 人 一 种 耳目 一 新 的 感觉。 


不 过 如 果 你 仔细 观察 图 14.24， 你 会 发 现 背景 图 并 没有 和 状态 栏 融 合 到 
一 起 ， 这 样 的 话 视觉 体验 就 还 是 没有 达到 最 佳 的 效果 。 虽 说 我 们 在 
12.7.2 小 节 已 经 学 习 过 如 何 将 背景 图 和 状态 栏 融合 到 一 起 ， 但 当时 是 借 
助 Design Support 库 完成 的 ， 而 我 们 这 个 项 目 中 并 没有 引入 Design 
Support 库 。 


当然 如 果 还 是 模仿 12.7.2 小 节 的 做 法 ， 引 入 Design _ Support 库 ， 然 后 能 套 














CoordinatorLayout、AppBarLayout、CollapsingToolbarLayonut 等 布局 ， 也 
能 实现 背景 图 和 状态 栏 融合 到 一 起 的 效果 ， 不 过 这 样 做 就 过 于 厅 烦 了 ， 

这 里 我 准备 教 你 另外 一 种 更 简单 的 实现 方式 。 修 改 WeatherActivity 中 的 
代码 ， 如 下 所 示 : 


public class WeatherActivity extends AppCompatActivity { 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceSstate); 
if (Build.VERSION.SDK_INT >= 21) { 
View decorView = getWindow().getDecorView(); 


View.SYSTEM_UI_FLAG LAYOUT_FULLSCREEN 
| View.SYSTEM UI_FLAG LAYOUT_STABLE); 
getwindow().setStatusBarColor (Color .TRANSPARENT); 


setContentView(R.1layout.activity _ weather); 


} 


由 于 这 个 功能 是 Android 5.0 及 以 上 的 系统 才 文 持 的 ， 因 此 我 们 先 在 代码 
中 做 了 一 个 系统 版 本 号 的 判断 ， 只 有 当 版 本 号 大 于 或 等 于 21， 也 就 是 
5.0 及 以 上 系统 时 才 会 执行 后 面 的 代码 。 


接着 我 们 调用 了 getwindow() ,getDecorview() 方 法 拿 到 当前 活动 的 
DecorView， 再 调用 它 的 setsystemuivisibility() 方 法 来 改变 系统 UI 的 
显示 ， 这 里 传 入 view.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN 和 | 
View.SYSTEM_UI_FLAG_LAYOUT_STABLE 就 表示 活动 的 布局 会 显示 在 状态 栏 
上 面 ， 最 后 调用 一 下 setstatusBarcolor() 方 法 将 状态 栏 设置 成 透明 色 。 


仅仅 这 些 代 码 就 可 以 实现 让 背景 图 和 状态 栏 融合 到 一 起 的 效 宋 了。 不 
过 ， 如 果 运 行 一 下 程序 ， 你 会 发 现 还 是 有 些 问 题 ， 天 气 界 面 的 头 布 局 几 
乎 和 系统 状态 栏 紧 贴 到 一 起 了 ， 如 图 14.25 所 示 。 
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图 14.25” 头 布局 和 状态 栏 紧 贴 在 一 起 


这 是 由 于 系统 状态 栏 已 经 成 为 我 们 布局 的 一 部 分 ， 因 此 没有 单独 为 它 留 
出 空间 。 当 然 ， 这 个 问题 也 是 非常 好 解决 的 ， 借 助 
android:fitssSystemwindows 属 性 就 可 以 了 。 修改 activity_weather.xml 中 
的 代码 ， 如 下 所 示 : 


<FrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:background="@color/colorPrimary"> 


<ScrollView 
android:id="@+id/weather_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:scrollbars="none" 
android:overscrollMode="never"> 


<LinearLayout 


android:orientation="vertical" 
android:layout_ width="match_parent" 
android:layout_height="wrap_content" 
android:fitsSystemWindows="true"> 


</LinearLayout> 


</ScrollView> 


</FrameLayout> 


这 里 在 ScrollView 的 LinearLayout 中 增加 了 android:fitssSystemwindows 属 
性 ， 设 置 成 true 就 表示 会 为 系统 状态 栏 留 出 空间 。 现 在 重新 运行 一 下 代 
码 ， 效 果 如 图 14.26 所 示 。 
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图 14.26 为 系统 状态 栏 留 出 空间 


OK， 这 样 第 三 阶段 的 开发 工作 也 都 完成 了 ， 我 们 把 代码 提交 一 下 。 


yit-add :; 
git commit -m "加 入 显示 天 气 信 息 的 功能 。" 
git push origin master 


14.6 手动 更 新 天 气 和 切换 城市 


i 二 第 三 阶段 的 开发 ， 现 在 酷 欢 天 气 的 主体 功能 已 经 有 了 ， 不 过 你 会 发 
现 目前 存在 着 一 个 比较 严重 的 bug， 束 是 当 你 选中 了 茶 一 个 城市 之 后 ， 
就 没 法 再 去 查看 其 他 城市 的 天 全， 即使 退出 程序 ， 下 次 进来 的 时 候 还 

会 直接 跳 转 到 WeatherActivity。 


因此 ， 在 第 四 阶段 中 我 们 要 加 入 切换 城市 的 功能 ， 并 且 为 了 能 够 实时 获 
取 到 最 新 的 天 气 ， 我 们 还 会 加 入 手动 更 新 天 气 的 功能 。 


14.6.1 手动 更 新 天 气 

先 来 实现 一 下 手动 更 新 天 气 的 功能 。 由 于 我 们 在 上 一 太 中 对 天 所 信 四 \ 进 
行 了 缓存， 目前 每 次 展示 的 都 是 级 存 中 的 数据 因此 现在 非常 需要 一 种 
方式 能 够 让 用 户 手动 更 新 天 和 气 信息 


至 于 如 何 触发 更 新 事件 呢 ? 这 里 我 准备 采用 下 拉 刷 新 的 方式 ， 正 好 我 们 
之 前 也 学 过 下 拉 刷 新 的 用 法 ， 实 现 起 来 会 比较 简单 。 


首先 修改 activity_weather.xml 中 的 代码 ， 如 下 所 示 : 























yout 

s:android="http: //s che a oid.com/apk/res/android" 
oid:layout_ width="matc ne a rent" 

oid:layout_height Cora ont 

id:backg nd=" P y 


<android. pp rt.v4. widge et. Sbe eRefreshLayout 
efresh" 


android:id="@+id/swipe_ 
androld: Jayout Width siat ch_parent" 
ndroid:layout_height="match_parent" 
ScrollView 
android:id="@+id/weathe Ta ayo De 
android:layout_width=" ch_pa t 
android:lay ER tr por ren 
android:scrollbars="none" 
android:overSscrollMod 


</ScrollView> 
</android.support.v4.widget.SwipeRefreshLayout> 


</FrameLayout> 


可 以 看 到 ， 这 里 在 ScrollView 的 外 面 义 藤 套 了 一 层 SwipeRefreshLayout， 





这 样 ScrollView 就 自动 拥有 下 拉 刷 新 功能 了 。 
然后 修改 WeatherActivity 中 的 代码 ， 加 入 更 新 天 气 的 处 理 罗 辑 ， 如 下 所 


外: 


public class WeatherActivity extends AppCompatActivity { 


public SwipeRefreshLayout SwipeRefresh 
private String mweatherId; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 


swipeRefresh = (SwipeRefreshLayout) findViewById(R.id.swipe_refresh); 
swipeRefresh.setColorSchemeResources(R.color.colorPrimary); 
SharedPreferences prefs = PreferenceManager . 
getDefaultSharedPreferences(this); 
String weatherString = prefs.getSstring("weather", null); 
if (weatherString != null) { 
// 有 缓存 时 直接 解析 天 气 数据 
Weather weather = Utility.handleweatherResponse(weatherString) ， 
mweatherId = weather .basic.weatherId; 
ShowweatherInfo(weather ) ; 
} else { 
// 无 缓存 时 去 服务 器 查询 天 气 
mweatherId = getIntent().getStringExtra("weather_id") ， 
weatherLayout .SetVisibility(View.INVISIBLE) ， 
requestweather (mweatherId); 





swipeRefresh.setOonRefreshListener(new SwipeRefreshLayout. 
OnRefreshListener() { 
@Override 
public void onRefresh() { 
requestweather (mweatherId); 
} 


}); 





} 


/x* 
* 根据 天 气 id 请 求 城市 天 气 信息 
SF 

public void requestweather(final String weatherId) { 


String weatherUrl = "http://guolin.tech/api/weather?cityid=" + 

weatherId + "&key=bc0418b57b2d4918819d3974ac1285d9"，; 
HttpUtil.sendOkHttpRequest(weatherUrl, new Callback() { 

@Override 

public void onResponse(Call call, Response response) throws IOException { 


runonUiThread(new Runnable() { 
@Override 
public void run() { 
if (weather != null && "ok".equals(weather.status)) { 
SharedPreferences.Editor editor = PreferenceManager. 
getDefaultSharedPreferences(WeatherActivity. 
this).edit(); 
editor.putSstring("weather", responseText); 
editor.apply(); 
mweatherId = weather .basic.weatherId; 
showwWeatherIinfo(weather); 
} else { 
Toast .makeText (WeatherActivity .this, "获取 天 气 信息 失败 "， 
Toast .LENGTH_SHORT) .show( ); 
} 


swipeRefresh.setRefreshing(false); 


}); 
} 


@Override 
public void onFailure(Call call, IOException e) { 
e.printstackTrace(); 
runonUiThread(new Runnable() { 
@Override 
public void run() { 
Toast.makeText (WeatherActivity.this, "获取 天 气 信息 失败 "， 
Toast .LENGTH_SHORT). show( ); 
swipeRefresh.setRefreshing(false); 


于 3 
} 


}); 
loadBingPic(); 








修改 的 代码 并 不 算 多 ， 首 先 在 oncreate() 方 法 中 获取 到 了 
SwipeRefreshLayout 的 实例 ， 然 后 调用 setcolorschemeResources() 方 法 
来 设置 下 拉 刷 新 进度 条 的 颜色 ， 这 里 我 们 就 使 用 主题 中 的 colorPrimary 
作为 进度 条 的 颜色 了 。 接着 定义 了 一 个 mweatherId 变 量 ， 用 于 记录 城市 
的 天 气 id， 然后 调用 setonRefreshListener() 方 法 来 设置 一 个 下 拉 刷 新 
的 监听 器 ， 当 触 有 了 下 拉 刷 新 操作 的 时 候 ， 就 会 回调 这 个 监听 器 的 
onRefresh ) 方 法 ， 我 们 在 这 里 去 调用 requestweather( ) 方 二 诈 求 天气 信 
县 就 可 以 了 。 


另外 不 要 瑟 记 ， 当 请 求 结 束 后 ， 还 需要 调用 SwipeRefreshLayout 的 
setRefreshing() 方 法 并 传 入 false， 用 于 表示 刷新 事件 结束 ， 并 隐藏 刷 
新 进度 条 。 


程序， 并 在 屏 大 的 主 界面 向 下 拖 动 ， 效 果 如 图 14.27 
示 。 























”预报 


2016-08-15 


2016-08-16 


2016-08-17 


2016-08-18 


2016-08-19 


2016-08-20 


2016-08-21 





图 14.27 手动 更 新 天 气 

更 新 完 天 气 信 息 之 后 ， 下 拉 进 度 条 会 自动 消失 。 

14.6.2 切换 城市 

完成 了 手动 更 新 天 气 的 功能 ， 接 下 来 我 们 继续 实现 切换 城市 功能 。 
既然 是 要 切换 城市 ， 那 么 就 肯定 需要 避 历 全 国 省 市 县 的 数据 ， 而 这 个 功 
能 我 们 早 在 14.4 节 就 已 经 完成 了 ， 并 且 当 时 考虑 为 了 方便 后 面 的 复 用 ， 


特意 选择 了 在 碎片 当中 实现 。 因 此 ， 我 们 其 实 只 需要 在 天 气 界 面 的 布局 
中 引入 这 个 碎片 ， 就 可 以 快速 集成 切换 城市 功能 了 。 





























虽说 实现 原理 很 简单 ， 但 是 显然 我 们 也 不 可 能 让 引入 的 碎片 把 天 气 界 面 
遮挡 住 ， 这 又 该 怎么 办 呢 ? 还 记得 12.3 节 学 过 的 滑动 菜单 功能 吗 ? 将 碎 
片 放 入 到 滑动 菜单 中 真是 再 合适 不 过 了 ， 正 常情 况 下 它 不 占据 主 界面 的 
想 要 切换 城市 的 时 候 只 需要 通过 滑动 的 方式 将 菜单 显示 出 来 
就 可 以 了 。 


下 面 我 们 就 按照 这 种 思路 来 实现 。 前 先 按 照 Material Design 的 建议 ， 我 
们 需要 在 头 布局 中 加 入 一 个 切换 城市 的 按钮 ， 不 然 的 话 用 户 可 能 根本 就 
不 知道 屏幕 的 天 侧 边 缘 是 可 以 拖 动 的 。 修 改 tite.xml 中 的 代码 ， 如 下 所 
小 : 














<RelativeLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="?attr/actionBarSize"> 


<Button 
android:id="@+id/nav_button" 
android:layout_width="30dp" 
android:layout_height="30dp" 
android:layout_marginLeft="10dp" 
android:layout_alignParentLeft="true" 
android:layout_centerVertical="true" 
android:background="@drawable/ic_home" /> 


</RelativeLayout> 








这 里 添加 了 一 个 Button 作 为 切换 城市 的 按钮 ， 并 且 让 它 居 左 显 示 。 田 
外 ， 我 提前 准备 好 了 一 张 图 片 来 作为 按钮 的 背景 图 。 


接着 修改 activity_weather.xml 布 局 来 加 入 滑动 染 单 功能 ， 如 下 所 示 : 


<FrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent 
android:layout_height="match_parent" 
android:background="@color/colorPrimary"> 


<android. support. v4.widget. Es 
android:id= "@+id/drawer_ layou 
android:layout_width="match 站 
android:layout_height="match_parent"> 


<android. support. v4.widget. Sipon Piresnbayout 
android:id= "@+id/swipe_ refre 
android:layout_width="match paren 
android:layout_height="match_parent"> 


</android.support.v4.widget.SwipeRefreshLayout> 


<fragment 
android:id="@+id/choose_area_ fragment" 
android:name="com.coolweather .android.ChooseAreaFragment" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:layout_gravity="start" 
/> 


</android.support.v4.widget.DrawerLayout> 


</FrameLayout> 


可 以 看 到 ， 我 们 在 SwipeRefreshLayout 的 外 面 又 嵌 套 了 一 层 
DrawerLayout。DrawerLayout 中 的 第 一 个 子 控件 用 于 作为 主屏 幕 中 显示 
的 内 容 ， 第 二 个 子 控件 用 于 作为 滑动 菜单 中 显示 的 内 容 ， 因 此 这 里 我 们 
在 第 二 个 子 控件 的 位 置 添 加 了 用 于 壳 历 省 市 县 数据 的 碎片 。 


接 下 来 需要 在 WeatherActivity 中 加 入 滑动 菜单 的 逻辑 处 理 ， 修 改 
WeatherActivity 中 的 代码 ， 如 下 所 示 : 


public class WeatherActivity extends AppCompatActivity { 














public DrawerLayout drawerLayout; 


private Button navButton; 


@Ooverride 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceSstate); 


drawerLayout = (DrawerLayout) findViewById(R.id.drawer_layout); 
navButton = (Button) findViewById(R.id.nav_button); 


navButton.setonCclickListener(new View.OnClickListener() { 


public void onClick(View v 
drawerLayout .openDrawer (GravityCompat .START); 
} 
}); 





很 简单 ， 首 先 在 oncreate() 方 法 中 获取 到 新 增 的 DrawerLayout 和 Button 
的 实例 ， 然 后 在 Button 的 点 击 事 件 中 调用 DrawerLayout 的 openDrawer() 
方法 来 打开 滑动 采 单 就 可 以 了 。 


不 过 现在 还 没有 结束 ， 因 为 这 仅仅 是 打开 了 清 动 米 所 而 已， 我 们 还 需要 
处 理 切 换 城市 后 的 逻辑 才 行 。 这 个 工作 就 必须 要 在 ChooseAreaFragment 
中 进行 了 ， 因 为 之 前 选中 了 某 个 城市 后 是 跳 转 到 WeatherActivity 的 ， 而 
现在 由 于 我 们 本 来 就 是 在 WeatherActivity 当 中 的 ， 因 此 并 不 需要 跳 转 ， 

只 是 去 请 求 新 选择 城市 的 天 气 信息 就 可 以 了 。 


那么 很 显然 这 里 我 们 需要 根据 ChooseAreaFragment 的 不 同 状态 来 进行 不 
同 的 逻辑 处 理 ， 修 改 ChooseAreaFragment 中 的 代码 ， 如 下 所 示 : 


public class ChooseAreaFragment extends Fragment { 








@Override 

public void onActivityCreated(Bundle savedInstanceState) { 
super .onActivityCreated(savedInstanceState); 
listView.setOnItemClickListener(new AdapterView.OnItemClickListener() { 


@override 
public void onItemClick(AdapterView<?> parent, View view, int position, 
long id) { 
if (currentLevel == LEVEL_PROVINCE) 
selectedProvince = provinceList.get(position); 
queryCities(); 
} else if (currentLevel == LEVEL_CITY) { 
SelectedCity = cityList.get(position); 
queryCounties(); 
} else if (currentLevel == LEVEL_COUNTY) { 

String weatherId = countyList.get(position).getweatherId(); 

if (getActivity() instanceof MainActivity 
Intent intent = new Intent(getActivity(), WeatherActivity. 

class); 
intent.putExtra("weather_id", weatherId); 
startActivity(intent 
getActivity().finish(); 

} else if (getActivity() instanceof WeatherActivity) { 
WeatherActivity activity = (WeatherActivity) getActivity(); 
activity.drawerLayout.closeDrawers(); 
activity.swipeRefresh.setRefreshing(true); 
activity.requestweather (weatherId); 








这 里 我 使 用 了 一 个 Java 中 的 小 技巧 ，instanceof 关 键 字 可 以 用 来 判断 一 
个 对 象 是 否 属 于 某 个 类 的 实例 。 我 们 在 碎片 中 调用 getActivity() 方 
法 ， 然 后 配合 instanceof 关 键 字 ， 就 能 轻松 判断 出 该 碎片 是 在 
MainActivity 当 中 ， 还 是 在 weatherActivity 当 中 。 如 果 是 在 MainActivity 
当中 ， 那 么 处 理 逻 辑 不 变 。 如 果 是 在 WeatherActivity 当 中 ， 那 么 束 关 闭 
滑动 菜单 ， 显 示 下 拉 刷 新 进度 条 ， 然 后 请 求 新 城市 的 天 气 信息 。 


这 样 我 们 就 把 切换 城市 的 功能 全 部 完成 了 ， 现 在 可 以 重新 运行 一 下 程 
序 ， 效 果 如 图 14.28 所 示 。 
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图 14.28 拥有 切换 城市 按钮 的 天 气 界面 


可 以 看 到 ， 标 题 栏 上 多 出 了 一 个 用 于 切换 城市 的 按钮 。 点 击 该 按钮 ， 或 
和 
14.29 及 未。 











图 14.29 显示 滑动 表单 界面 


然后 我 们 束 可 以 在 这 里 切换 其 他 城市 了 。 选 中 城市 之 后 滑动 琳 单 会 自动 
关闭 ， 并 且 主 界面 上 的 天 气 信息 也 会 更 新 成 你 选择 的 那个 城市 。 


这 样 ， 第 四 阶段 的 开发 任务 也 完成 了 。 当 然 ， 仍 然 不 要 起 记 提 交代 码 。 


git add . 
git commit -m "新 增 切换 城市 和 手动 更 新 天 气 的 功能 。" 
git push origin master 








14.7 后 台 目 动 更 狐 天 气 


为 了 要 让 酷 欧 天 气 更 加 智能 ， 在 第 五 阶段 我 们 准备 加 入 后 台 自 动 更 新 天 
| 这 样 就 可 以 尽 可 能 地 保证 用 户 每 次 打开 软件 时 看 到 的 部 钙 最 
新 天 和 气 言 息 。 


要 想 实现 上 述 功能 ， 就 需要 创建 一 个 长 期 在 后 台 运 行 的 定时 任务 ， 这 个 
功能 肯定 是 难 不 倒 你 的 ， 因 为 我 们 在 13.5 节 中 惑 已 经 学 习 过 了 。 


首先 在 service 包 下 新 建 一 个 服务 ， 右 击 


com.coolweather.android.service “New ”Service > Service， 创 建 一 个 
AutoUpdateService， 并 将 Exported 和 Enabled 这 两 个 属性 都 勾 中 。 然 后 修 
改 AutoUpdateService 中 的 代码 ， 如 下 所 示 : 


public class AutoUpdateService extends Service { 





@Override 
public IBinder onBind(Intent intent) { 
return null; 


@override 
public int onStartCommand(Intent intent, int flags, int startId) { 
updateweather(); 
updateBingPic(); 
AlarmManager manager = (AlarmManager) getSystemService(ALARM SERVICE); 
int anHour = 8 * 60 * 60 * 1009; // 这 是 8 小 时 的 毫秒 数 
long triggerAtTime = SystemClock.elapsedRealtime() + anHour 
Intent i = new Intent(this, AutoUpdateService.class); 
PendingIntent pi = PendingIntent.getService(this, ©0, i, 0); 
manager .cancel(pi); 
manager .set (AlarmManager .ELAPSED_REALTIME_ WAKEUP, triggerAtTime, pi); 
return super.onStartCommand(intent, flags, startId); 


private void updateweather(){ 
SharedPreferences prefs = PreferenceManager .getDefaultSharedPreferences(this); 
String weatherString = prefs.getString("weather"，nul1) 
if (weatherString != null) { 
// 有 缓存 时 直接 解析 天 气 数据 
Weather weather = Utility.handleweatherResponse(weatherString) ， 
String weatherId = weather .basic.weatherId 


String weatherUrl = "http://guolin.tech/api/weather?cityid=" + 
weatherId + "&key=bc0418b57b2d4918819d3974ac1285d9"，; 
HttpUtil.sendOkHttpRequest(weatherUrl, new Callback() { 
@override 
public void onResponse(Call call, Response response) throws 
IOException { 
String responseText = response.body().string(); 
Weather weather = Utility.handleweatherResponse(responseText); 
if (weather != null && "ok".equals(weather.status)) { 
SharedPreferences.Editor editor = PreferenceManager. 
getDefaultSharedPreferences(AutoUpdateService.this). 
edit(); 
editor.putSstring("weather", responseText); 
editor.apply(); 


} 


@override 
public void onFailure(Call call, IOException e) { 
e.printStackTrace() ; 


}); 
} 


* 更 新 必 应 每 日 一 图 
tA 
private void updateBingPic() { 
String requestBingPic = "http://guolin.tech/api/bing_pic"; 
HttpUtil.sendOkHttpRequest(requestBingPic, new Callback() { 
@override 
public void onResponse(Call call, Response response) throws IOException { 
String bingPic = response. body(). :string(); 
SharedPreferences.Editor editor = 全 getDefault 
he this).edit(); 
editor.putSstring("bing_pic", bingPic); 
editor.apply(); 


@Ooverride 
public void onFailure(Call call, IOException e) { 
e.printSstackTrace(); 


可 以 看 到 ， 在 onstartcommand() 方 法 中 先是 调用 了 updateweather() 方 法 
来 更 新 天 气 ， 然 后 调用 了 updateBingPic() 方 法 来 更 新 背景 图 片 。 这 里 我 
们 将 更 新 后 的 数据 直接 存储 到 SharedPreferences 文 件 中 就 可 以 了 ， 因 为 
打开 WeatherActivity 的 时 候 都 会 优先 从 SharedPreferences 绥 存 中 读 取 数 

据 。 


之 后 就 是 我 们 学 习 过 的 创建 定时 任务 的 技巧 了 ， 为 了 保证 软件 不 会 消耗 
过 多 的 流量 ， 这 里 将 时 间 间 隔 设 置 为 8 小 时 ，8 小 时 后 
AutoUpdateReceiver 的 onstartcommand() 方 法 就 会 重新 执行 ， 这 样 也 就 实 
现 后 台 定 时 更 新 的 功能 


不 过 ， 我 们 还 需要 在 代码 某 处 去 激活 AutoUpdateService 这 个 服务 才 行 。 
修改 WeatherActivity 中 的 代码 ， 如 下 所 示 : 


public class WeatherActivity extends AppCompatActivity { 








/x 
* 处 理 并 展示 Weather 实 体 类 中 的 数据 。 
和 





private void showweatherInfo(Weather weather) { 
weatherLayout.setVisibility(View.VISIBLE); 
Intent intent = new Intent(this, AutoUpdateService.class); 
startService(intent); 
} 
} 


可 以 看 到 ， 这 里 在 showweatherInfo() 方 法 的 最 后 加 入 启动 
AutoUpdateService 这 个 服务 的 代码 ， 这 样 只 要 一 旦 选中 了 茶 个 城市 并 成 
功 更 新 天 气 之 后 ，AutoUpdateService 就 会 一 直 在 后 台 运 行 ， 并 保证 每 8 





小 时 更 新 一 次 天 气 。 
现在 可 以 再 提交 一 下 代码 : 


git add . 
git commit -m "增加 后 台 自 动 更 新 天 气 的 功能 。" 
git push origin master 


14.8 ”修改 图 标 和 名 称 


目前 的 酷 欧 天 气 看 起 来 还 不 太 像 是 一 个 正式 的 软件 ， 为 什么 呢 ? 因为 都 
还 没有 一 个 像样 的 图 标 呢 。 一 直 使 用 Android Studio 目 动 生成 的 图 标 确实 
不 太 合适 ， 是 时 候 需要 换 一 下 了 。 


这 里 我 事先 准备 好 了 一 张 图 片 来 作为 软件 图 标 ， 由 于 我 也 不 是 搞 美术 
的 ， 因 此 图 标 设计 得 非常 简单 ， 如 图 14.30 所 示 。 


图 14.30 ” 酪 欧 天 气 的 图 标 


理论 上 来 讲 ， 我 们 应 该 给 这 个 图 标 提 供 几 种 不 同 分 辨 率 的 版 本 ， 然 后 分 
别 放 入 到 相应 分 辨 率 的 mipmap 目 录 下 ， 这 里 简单 起 见 ， 我 束 都 使 用 同 
一 张 图 了 。 将 这 张 图 片 命名 成 logo.png， 放 入 到 所 有 以 mipmap 开 头 的 目 
录 下 ， 然 后 修改 AndroidManifest.xml 中 的 代码 ， 如 下 所 示 : 


manifest xmlns:android="http://sche mas android.com/apk/res/android" 
package="com.coolweather .android" 


uses-permission android:name="android.per On.INTERNET" /> 
<application 


android:name="org.1i Ee LitePalApplication" 
A < 
id:ico 


android: EH Te A nana 
</appli ication 


</manifest> 


这 里 将 <application> 标 签 的 android:icon 属 性 指定 成 @mipmap/logo 整 
可 以 修改 程序 图 标 了 。 接 下 来 我 们 还 需要 修改 一 下 程序 的 名 称 ， 打 开 














res/values/string， xml 文 件 ， 其 中 app_name 对 应 的 就 是 程序 名 称 ， 将 它 1 
改 成 酷 软 天气 即 可 ， 如 下 所 示 : 


<resources> 
<string name="app_name"> 酷 欧 天 气 </string> 
</resources> 


NS 





现在 重新 运行 一 过 程序 ， 这 时 观察 酷 欧 天 气 的 昌 面 图 标 ， 如 图 14.31 所 


4 宣 口 


Phone 


图 14.31 手机 哥 面 图 标 
养 成 良好 的 习惯 ， 仍 然 不 要 忘记 提交 代码 。 


i nhs : 
i 


这 样 我 们 就 终于 大 功 告 成 了 ! 


14.9 ”你 还 可 以 做 的 事情 


过 五 个 阶段 的 开 及 ， 酷 欧 天 气 已 经 是 一 个 完善 、 成 训 的 软件 了 吗 ? 虽 
时 还 差 得 远 呢 ! 现 硅 的 酷 耽 天 气 只 能 说 是 真 备 了 一 一 些 最 基本 的 功能 
和 那些 商用 的 天 气 软件 比 起 来 还 有 很 大 的 差距 ， 因此 你 仍然 还 有 非常 巨 
大 的 发 挥 空间 来 对 它 进行 完善 。 


比如 说 以 下 功能 是 你 可 以 考虑 加 入 到 酷 欧 天 气 中 的 。 











。 增加 设置 选项 ， 让 用 户 选择 是 否 多 许 后 合 目 动 更 新 天 气 ， 以 及 设 定 
更 新 的 频率 。 


。 优化 软件 界面 ， 
的 天 气 自动 切换 背景 


0 
四 换 。 











提供 更 加 完整 的 天 气 信息 ， 目 前 我 们 只 使 用 了 和 风 天 气 返 回 的 一 小 
部 分 数据 而 已 。 
妨 外 ， 由 于 酯 欧 天 气 的 源 但 已 经 托 营 在 了 GitHub 上 面 ， 如 末 你 想 在 现 有 


代码 的 基础 二 继 乡 壹 对 这 个 项 目 进行 完善 ， 束 可 以 使 用 GitHub 的 Fork 功 
能 。 


首先 登录 你 自己 的 GitHub 账 号 ， 然 后 打开 酷 欧 天 气 版 本 库 的 主 
页 : https:/github.comy/guolindevwcoolweather， 这 时 在 页 面 头 部 的 最 右 侧 
会 有 一 个 Fork 按 钮 ， 如 图 14.32 所 示 。 


人 Watchv 0 会 Star 0 WFork 0 


图 14.32” GitHub Fork 按 钮 


点 击 一 下 Fork 按 钮 就 可 以 将 酷 欧 天 气 这 个 项 目 复制 一 份 到 你 的 账号 下 ， 


再 使 用 git ”clone 命令 将 它 殉 隆 到 本 地 ， 然 后 你 束 可 以 在 现 有 代码 的 基 
础 上 随心 所 欲 地 添加 任何 功能 并 提交 了 。 





将 应 用 友 布 到 


第 15 半 最 后 一 步 
360 应 用 商店 


应 用 已 经 开发 出 来 了 ， 下 一 步 我 们 需要 思考 推广 方面 的 工作 。 那 么 如 何 
才能 让 更 多 的 用 户 知道 并 使 用 我 们 的 应 用 程序 呢 ? 在 手机 领域 ， 最 音 见 
的 做 法 融 是 将 程序 发 布 到 茶 个 应 用 商店 中 ， 这 样 用 户 融 可 以 通过 商店 找 
到 我 们 的 应 用 程序 ， 然 后 轻松 地 进行 下 载 和 安装 。 


说 到 应 用 商店 ， 在 Android 领 域 真 的 可 以 称 得 上 是 百 家 和 争鸣， 除了 谷歌 
官方 推出 的 Google Play 之 外 ， 在 中 国 还 有 像 360、 理 豆荚 、 百 度 、 应 用 
宇 等 知名 的 应 用 商店 。 当 然 ， 这 些 商 店 所 提供 的 功能 都 是 比较 类 似 的 ， 
发 布 应 用 的 方法 也 大 同 小 异 ， 因 此 这 里 我 们 就 只 学 习 如 何 将 应 用 发 布 到 
0 




















15.1 生成 正式 签名 的 APK 文 件 


之 前 我 们 一 直 都 是 通过 Android Studio 来 将 程序 安装 到 手机 上 的 ， 而 它 背 
后 实际 的 工作 流程 是 ，Android ”Studio 会 将 程序 代码 打包 成 一 个 APK 文 
件 ， 然 后 将 这 个 文件 传输 到 手机 上 ， 最 后 再 执行 安装 操作 。Android 系 

统 会 将 所 有 的 APK 文 件 识别 为 应 用 程序 的 安装 包 ， 类 似 于 Windows 系 统 
上 的 EXE 文 件 。 


但 并 不 是 所 有 的 APK 文 件 都 能 成 功 安装 到 手机 上 ，Android 系 统 要 求 只 
有 签名 后 的 APK 文 件 才 可 以 安装 ， 因 此 我 们 还 需要 对 生成 的 APK 文 件 进 
行 签名 才 行 。 那 么 你 可 能 会 有 疑问 了 ， 直 接 通 过 Android Studio 来 运行 程 
序 的 时 候 好 像 并 没有 进行 过 签名 操作 啊 ， 为 什么 还 能 将 程序 安装 到 手机 
上 呢 ? 这 是 因为 Android Studio 使 用 了 一 个 默认 的 keystore 文 件 帮 我 们 上 自 
动 进行 了 签名 。 点 击 Android Studio 右 侧 工 具 栏 的 Gradle 项目 名 
:app 一 Tasks -android， 双 击 signingReport， 结 果 如 图 15.1 所 示 。 


Variant: debug 
Config: debug 


Store: C:\Users\Administrator\. android\debug. keystore 


图 15.1 查看 默认 的 keystore 文 件 


也 就 是 说 ， 我 们 所 有 通过 Android ”Studio 来 运行 的 程序 都 是 使 用 了 这 个 
debug.keystore 文 件 来 进行 签名 的 。 不 过 这 仅仅 适用 于 开发 阶段 而 已 ， 现 
在 酷 欧 天 气 已 经 快要 发 布 了 ， 要 使 用 一 个 正式 的 keystore 文 件 来 进行 签 

下 面 我 们 就 来 学 习 一 下 ， 如 何 生 成 一 个 带 有 正式 签名 的 APK 文 








15.1.1 使 用 Android Studio 生 成 


先 学 习 一 下 如 何 使 用 Android ”Studio 来 生成 正式 签名 的 APK 文 件 。 点 击 
Android Studio 导 航 栏 上 的 Build -Generate Signed APK， 首 次 点 击 可 能 
会 提示 让 我 们 输入 操作 系统 的 密码 ， 如 图 15.2 所 示 。 





加 
Enter Master Password 





2 ooo | 


Master password is required to unlock the password database. 
The password database will be unlocked during this session 


for all subsystems. 


Requested by: Keystore Step 


Help i Cancel | Reset... 








图 15.2 输入 操作 系统 密码 提示 框 
输入 密码 之 后 点击 OK， 则 会 弹出 如 图 15.3 所 示 的 创建 签名 APK 对 话 框 。 





二 二 
网 Generate Signed APK 


Create new... Choose existing... 











Key store password: 








Key alias: 














Key password: 





[) Remember passwords 


| Previous | Cancel Help 








图 15.3 ”创建 签名 APK 对 话 框 


由 于 目前 我 们 还 没有 一 个 正式 的 keystore 文 件 ， 所 以 应 该 点 击 Create new 
按钮 ， 然 后 会 弹出 一 个 新 的 对 话 框 来 让 我 们 填写 创建 keystore 文 件 所 必 
要 的 信息 。 根 据 自己 的 实际 情况 进行 填写 就 行 了 ， 如 图 15.4 所 示 。 








网 New Key Store 





Key store path: | CAUsersWwdministratormDocuments\VguolinJks [图 

















Password: | Confirm: | 








Key 








Alias: 














Password: Confirm: | 














Validity (years): 





-Certificate 


First and Last Name: | Guo Lin 











Organizational Unit: | Personal 








Organization: Guo Lin 








City or Locality: Suzhou 








State or Province: Jiangsu 

















Country Code (XM: | 86 














图 15.4 填写 keystore 文 件 信 息 


这 里 需要 注意 ， 在 Validity 那 一 栏 填 写 的 是 keystore 文 件 的 有 效 时 长 ， 单 
位 是 年 ， 一 般 建议 时 间 可 以 填 得 长 一 些 ， 比 如 我 填 了 30 年 。 然 后 点 击 
OK， 这 时 我 们 刚才 填写 的 信息 会 自动 填充 到 创建 签名 APK 对 话 框 当 
中 ， 如 图 15.5 所 示 。 




















到 
网 Generate Signed APK 








| Ci\Users\Administrator\Documents\guolin,jks 


Create new... | Choose existing... 


Key store path: 








Key store password: 











Key alias: 














Key password: 





[LL] Remember passwords 


| Previous | | Next | Cancel | | Help 

















图 15.5 信息 自动 填充 完整 


如 果 你 希望 以 后 都 不 用 再 输 keystore 的 密码 了 ， 可 以 将 Remember 
passwords 选 项 勾 上 。 然 后 点 击 Next， 这 时 就 要 选择 APK 文 件 的 输出 地 址 


了 ， 如 图 15.6 所 示 。 





下 
网 Generate Signed APK 


Note: Proguard settings are specified using the Project Structure Dialog 





APK Destination Folder: | AndroidStudioprojects\CoolWeather | 本 | 








Build Type: | release 








Flavors: 








Previous Cancel Help 





图 15.6 ”选择 APK 文 件 的 输出 地 址 
这 里 默认 是 将 APK 文 件 生成 到 项 目的 根 目录 下 ， 我 就 不 做 修改 了 。 现 在 





点 击 Finish， 然 后 稍 等 一 段 时 间 ， APK 文 件 就 都 会 生成 好 了 ， 并 且 会 在 
右上 和 角 弹 出 一 个 如 图 15.7 所 示 的 提示 。 


Generate Signed APK 
APK(s) generated successfully. 
Show in Explorer 


图 15.7 提示 APK 文 件 生 成 成 功 


我 们 点 击 提 示 上 的 Show in Explorer 可 以 立刻 查看 生成 的 APK 文 件 ， 如 图 
15.8 所 示 。 


上 出 app 

Nh build 

hh gradle 

且 .gitignore 

(BB app-release.apk 
加 build.gradle 


| CoolWeather.im| 








四 
图 15.8 ”查看 生成 的 APK 文 件 

这 里 的 app-release.apk 就 是 带 有 正式 签名 的 APK 文 件 了 。 
15.1.2 ”使 用 Gradle 生 成 


上 一 小 节 中 我 们 使 用 了 Android Studio 提 供 的 可 视 化 工具 来 生成 带 有 正式 
签名 的 APK 文 件 ， 除 此 之 外 ，Android Studio 其 实 还 提供 了 另外 一 种 方式 
一 一 使 用 Gradle 生 成 ， 下 面 我 们 就 来 学 习 一 下 。 


Gradle 是 一 个 非常 先进 的 项 目 构建 工具 ， 在 Android Studio 中 开发 的 所 有 
项 目 都 是 使 用 它 来 构建 的 。 在 之 前 的 项 目 中 ， 我 们 也 体验 过 了 Gradle 带 
来 的 很 多 便利 之 处 ， 比 如 说 当 需 要 添加 依赖 库 的 时 候 不 需要 自己 再 去 手 
下 载 了 ， 而 是 直接 在 dependencies 闭 包 中 添加 一 句 引 用 声明 就 可 以 


不 过 这 里 我 要 提醒 你 一 句 ， 如 果 你 想 将 Gradle 完 全 精通 的 话 ， 这 个 难度 
就 比较 大 了 。Gradle 的 用 法 极为 丰富 ， 想 要 完全 掌握 它 的 用 法 ， 其 复杂 




















程度 并 不 亚 于 学 习 一 门 新 的 语言 〈Gradle 是 使 用 Groovy 语 言 编写 的 ) 。 

而 Android 中 主要 只 是 使 用 Gradle 来 构建 项 目 而 已 ， 因此 这 里 我 们 掌握 一 
些 它 的 基本 用 法 就 好 了 ， 重 点 还 是 要 放 在 功能 开发 上 面 ， 不 要 本 末 倒 置 
a 如 果 你 对 Gradle 非 常 感 兴趣 ， 也 可 以 到 网 上 去 查询 它 的 更 多 
用 法 。 


下 面 我 们 开始 学 习 如 何 使 用 Gradle 来 生成 带 有 正式 签名 的 APK 文 件 。 编 
辑 app/build.gradle 文 件 ， 在 android 闭 包 中 添加 如 下 内 容 : 


appii ationid "com.coolweather .android" 
I k 


eFile file ef( C:/Users/Administrator/Documents/guolin.jks') 
storepassvor d 3 
keyAlias 'guolinde 
keyPassword 294667 


minifyEnabled false 
proguardFiles getDefaultProguardFile('proguard-android.txt'), 
"proguard-rules.pro' 


可 以 看 到 ， 这 里 在 android 闭 包 中 添加 了 一 个 signingConfigs 闭 包 ， 然 后 在 
signingConfigs 闭 包 中 又 添加 了 一 个 config 闭 包 。 接 着 在 config 闭 包 中 配 
置 keystore 文 件 的 各 种 信息 ，storeFile 用 于 指定 keystore 文 件 的 位 置 ， 
storePassword 用 于 指定 密码 ，keyAlias 用 于 指定 别名 ， keyPassword 用 于 
指定 别名 密码 。 


将 签名 信息 都 配置 好 了 接 下 来 只 需要 在 生成 正式 版 APK 的 时 候 去 
应 用 这 个 配置 就 可 以 了 。 续 编辑 app/build.gradle 文 件 ， 如 下 所 示 : 


android { 














bui ildTypes 
release 
nifyEnable 8 false 
BE oguardFiles getDefa ultPro oguardFile('proguard-android.txt'), 
'pro guard-rule es.pro 
signingConfig signingConfigs.config 


这 里 我 们 在 buildTypes 下 面 的 release 闭 包 中 应 用 了 刚才 添加 的 签名 配 


置 ， 这 样 当 生成 正式 版 APK 文 件 的 时 候 融 会 目 动 使 用 我 们 刚才 配置 的 签 
名 信息 来 进行 签名 了 。 


现在 build.gradle 文 件 已 经 配置 完成 ， 那 么 我 们 如 何 才 能 生成 APK 文 件 

呢 ? 其 实 非 常 简单 ，Android Studio 中 内 置 了 很 多 的 Gradle Tasks， 其 中 
就 包括 了 生成 APK 文 件 的 Task。 点 击 右 侧 工具 栏 的 Gradle -项目 名 
:app 一 Tasks -build， 如 图 15.9 所 示 。 





| Gradle projects i , 
芒 十 一 | 纪 三 三 色 咏 | 芭 
个 CoolWeather 
(© CoolWeather (root 
© :app 
Es Tasks 
E83 android 
C3 build 
地 assemble 
RassembleAndroidTest 
条 assembleDebug 





和 assembleRelease 
亲 build 
RbuildDependents 
过 buildNeeded 

六 clean 


图 15.9 查看 内 置 Gradle Tasks 


其 中 assembleDebug 用 于 生成 测试 版 的 APK 文 件 ，assembleRelease 用 于 生 
成 正式 版 的 APK 文 件 ，assemble 用 于 同时 生成 测试 版 和 正式 版 的 APK 文 
件 。 在 生成 APK 之 前 ， 先 要 双击 clean 这 个 Task 来 清理 一 下 当前 项 目 ， 然 
后 双击 assembleRelease， 结 果 如 图 15.10 所 示 。 








| Run 已 CoolWeather:app [assembleRelease] 





pt 

| 男 |4 BUILD SUCCESSFUL 

| 名 5 

I 如 | Total time: 38. 048 secs 

| 地 14:13:17: External task execution finished “assembleRelease . 


Pp 和 4 Te a TODO 关 6 ee 局 9: 区 Tr 国 让 区 0: Messages 
图 15.10”assembleRelease 执 行 成 功 


可 以 看 到 ， 这 里 提示 我 们 BUILD SUCCESSFUL， 说 明 assembleRelease 
执行 成 功 了 。APK 文 件 会 自动 生成 在 app/build/outputs/apk 目 录 下 ， 如 图 
15.11 所 示 。 








_ 国 Praject 引 日 幸 | 亲 " 呈 | 
世 CoolWeather [CUsers nistratorAndroi 册 | 
> 站.gradle | 
四 .idea 
四 app 
四 build 
四 generated 





四 intermediates 
户 outputs 
吕 apk 
Bi app-release.apk 





目 app-release-unaligned.apk 


图 15.11 查看 生成 的 APK 文 件 


其 中 ，app-release.apk 就 是 带 有 正式 签名 的 APK 文 件 了 。 另 外 还 有 一 个 
app-release-unaligned.apk， 这 是 一 个 没有 经 过 对 齐 的 正式 版 APK 文 件 ， 
我 们 直接 忽略 它 就 可 以 了 。 


虽说 现在 APK 文 件 已 经 成 功 生 成 了 ， 不 过 还 有 一 个 小 细节 需要 注意 一 
下 。 目 前 keystore 文 件 的 所 有 信息 都 是 以 明文 的 形式 直接 配置 在 
build.gradle 中 的 ， 这 样 就 不 太 安全 。Android 推 荐 的 做 法 是 将 这 类 敏感 数 
据 配 置 在 一 个 独立 的 文件 里 面 ， 然 后 再 在 build.gradle 中 去 读 取 这 些 数 


据 。 


下 面 我 们 来 按照 这 种 方式 实现 。Android ”Studio 项 目的 根 目录 下 有 一 个 
gradle.properties 文 件 ， 它 是 专门 用 来 配置 全 局 键 值 对 数据 的 ， 我 们 在 
gradle.properties 文 件 中 添加 如 下 内 容 : 














KEY_PATH=C:/Users/Administrator/Documents/guolin.jks 
KEY | PASS= 2 

ALIAS_NAME=guolindev 

ALIAS_PASS=1234567 


可 以 看 到 ， 这 里 将 keystore 文 件 的 各 种 信息 以 键 值 对 的 形式 进行 了 配 
置 ， 然 后 我 们 在 build.gradle 中 去 读 取 这 些 数据 就 可 以 了 。 编 辑 
app/build.gradle 文 件 ， 如 下 所 示 : 


android { 
Sg ngConfigs { 
onfi t 
ri ls file(KEY_PATH) 
pa KEY_PASS 
中 eyAlia s ALTAs- NAME 
eyPassword ALIAS_PASS 
} 


} 


这 里 只 需要 将 原来 的 明文 配置 改 成 相应 的 键 值 ， 一 切 就 完工 了 上。 这样 直 
接 查 看 build.gradle 文 件 是 无 法 看 到 keystore 文 件 的 各 种 信息 的 ， 只 有 查看 
gradle.properties 文 件 才 能 看 得 到 。 然 后 我 们 只 需要 将 gradle.properties 文 
件 保 护 好 束 行 了 ， 比 如 说 将 它 从 Git 版 本 控制 中 排除 。 这 样 

gradle. properties 文 件 就 只 会 保留 在 本 地 ， 从 而 也 就 不 用 担心 keystore 文 件 
的 信息 会 泄漏 了 。 


15.1.3 ”生成 多 渠道 APK 文 件 


现在 你 已 经 掌握 了 两 种 生成 带 有 正式 签名 的 APK 文 件 的 方式 ， 从 简易 程 
度 上 来 两 种 方式 锚 不 多 ， 基 本 都 还 是 比较 简单 的 ， 选 择 使 用 哪 一 种 
全 和 赁 你 自己 的 喜好 。 


现在 APK 文 件 已 经 生成 好 了 ， 可 能 在 大 多 数 情况 下 ， 我 们 都 只 需要 一 个 
APK 文 件 就 足够 了 ， 不 过 本 小 节 中 我 们 再 来 讨论 一 种 比较 特殊 的 情况 
一 一 生成 多 渠道 APK 文 件 。 




















在 本 章 的 开头 就 已 经 提 到 过 ， 目 前 Android 领 域 的 应 用 商店 非常 多 ， 不 
像 苹果 只 有 一 个 App Store。 当 然 我 们 完全 可 以 使 用 同一 个 APK 文 件 来 上 
架 不 同 的 应 用 商店 ， 但 是 如 果 你 有 一 些 特殊 需求 的 话 ， 比 如 说 针对 不 同 
的 应 用 商店 渠道 来 定制 不 同 的 界面 ， 这 就 比较 头疼 了 。 


传统 情况 下 ， 开 发 这 种 差异 性 需求 非常 痛 百 ， 通 种 需要 维护 多 份 代 码 版 
本 ， 然 后 逐个 打 成 相 应 渠道 的 APK 文 件 。 一 旦 有 任何 功能 变更 就 苦 不 雯 
言 ， 因 为 每 份 代码 版 本 里 面 都 需要 逐个 修改 一 裔 。 


幸运 的 是 ， 现 在 Android Studio 提 供 了 一 种 非常 方便 的 方法 来 应 对 这 种 差 
异性 需求 ， 极 大 程度 地 解决 了 之 前 版 本 维护 困难 的 问题 ， 下 面 我 们 就 来 
hs 


比如 说 这 里 我 们 准备 生成 360 和 百度 两 个 渠道 的 APK 文 件 ， 那 么 修改 
app/build.gradle 文 件 ， 如 下 所 示 : 














可 以 看 到 ， 这 里 添加 了 一 个 productFlavors 闭 包 ， 然 后 在 该 闭 包 中 添加 
所 有 的 渠道 配置 就 可 以 了 。 注 意 Gradle 中 的 配置 规定 不 能 以 数字 开头 ， 

因此 这 里 我 将 360 的 渠道 名 配置 成 了 qihoo。 渠 道 名 的 闭 包 中 可 以 窗 写 

defaultConfig 中 的 任何 一 个 属性 ， 比 如 说 这 里 将 applicationId 属 性 进行 
了 复写 ， 那 么 最 终生 成 的 各 渠道 APK 文 件 的 包 名 也 将 各 不 相同 。 


接 下 来 我 们 开始 针对 不 同 渠 道 编写 差异 性 需求 。 在 app/src 目 录 下 (main 
的 平 级 目录 ) 新 建 一 个 baidu 目 录 ， 然 后 在 baidu 目 录 下 再 新 建 java 和 res 
这 两 个 目录 ， 如 图 15.12 所 示 。 























世 日 ] project ”| 全 站 | 举 " -| 
E32 coolweather | 
i 请 .gradle 
总 四 .idea 
加 四 app 
总 build 
上 户 libs 
了 户 src 
四 androidTest 
加 四 baidu 
加 java 
人 C3 res 
DD main 
DD test 





图 15.12 创建 渠道 专属 目录 


这 样 我 们 束 可 以 在 这 里 编写 百度 渠道 特有 的 功能 了 ，java 上 日 录用 于 存放 
代码 ，res 目 录用 于 存放 资源 ， 如 果 需 要 和 窗 写 AndroidManifest 文 件 中 的 内 
容 ， 还 可 以 在 baidu 目 录 下 再 新 建 一 个 AndroidManifest.xml 文 件 。 


当然 ， 实 际 上 我 们 并 没有 什么 渠道 差异 性 的 需求 ， 因 此 这 里 也 只 是 为 了 
演示 一 下 ， 我 们 就 给 不 同 渠 道 的 APK 起 一 个 不 同 的 应 用 名 吧 。 


应 用 名 之 前 是 定义 在 main/res/values/string.xml 文 件 中 的 ， 那 么 我 们 在 
baidu 目 录 下 也 建立 一 个 相同 的 目录 结构 ， 然 后 将 
baidu/res/values/string.xml 中 的 内 容 进 行 如 下 修改 : 

















<resources> 
<string name="app_name"> 酷 欧 百度 版 </string> 
</resources> 


这 样 百 度 渠 道 的 APK 就 会 使 用 baidu/res/values/string.xml 中 定义 的 应 用 名 
来 覆盖 原 有 的 应 用 名 。 同 样 的 道理 ， 我 们 再 新 建 一 个 qihoo 目 录 ， 人 然后 
目录 下 也 建立 相同 的 目录 结构 ， 并 将 string.xml 中 的 内 容 进 行 如 
下 修改 : 


<resources> 
<string name="app_name"> 酷 欧 369 版 </string> 
</resources> 











这 样 我 们 束 以 一 个 简单 的 示例 实现 渠道 差异 性 需求 了 ， 下 面 开 始 来 生成 
多 渠道 的 APK 文 件 。 观 察 右 侧 工具 栏 的 Gradle Tasks 列表 ， 你 会 发 现 里 
面 多 出 了 几 个 新 的 Task， 如 图 15.13 所 示 。 





| Gradle projects | 
| 和 仿 十 一 忆 三 云 虹 咏 施 
| 全 CoolWeather 
(© CoolWeather (root) 
© :app 
Ca Tasks 
[Fa android 
C3 build 
地 assemble 
寺 assembleAndroidTest 
洁 assembleBaidu 
上 assembleDebug 
地 assembleQihoo 
地 assembleRelease 
汪 build 
全 buildDependents 
地 buildNeeded 
全 clean 





alpel9 可 


图 15.13 查看 新 的 Task 


其 中 ， 如 果 你 只 想 生 成 百度 渠道 的 APK 文 件 ， 那 么 就 执行 
assembleBaidu; 如 果 你 只 想 生 成 360 渠 道 的 APK 文 件 ， 那 么 就 执行 
assembleQihoo; 如 果 你 想 一 次 性 生成 所 有 渠道 的 APK 文 件 ， 那 么 束 还 是 
执行 assembleRelease。 


除了 使 用 Gradle 的 方式 生成 之 外 ， 使 用 Android Studio 提 供 的 可 视 化 工具 
也 是 能 生成 多 渠道 APK 文 件 的 ， 如 图 15.14 所 示 。 





隔 
网 Generate Signed APK 











Note: Proguard settings are specified using the Project Structure Dialog 
APK Destination Folder | \AndroidStudioProjects\CoolWeather 
Build Type: | release 立 


Elavore, [ET 


qihoo 










| Brevious | Finish | Cancel Help 


图 15.14 使 用 可 视 化 工具 生成 多 渠道 APK 


这 里 我 们 可 以 选择 是 生成 百度 渠道 的 APK 文 件 ， 还 是 生成 360 渠 道 的 
APK 文 件 ， 如 果 你 想 一 次 性 生成 多 个 渠道 的 APK 文 件 ， 按 住 CTRL 键 就 
可 以 进行 多 选 了 。 


接 下 来 我 们 可 以 通过 adb instal1 命 令 将 生成 好 的 APK 文 件 安装 到 模拟 
器 上 ， 如 网 15.15 所 示 。 











一 于 一 
[ 节 管理 员 : C\Windows 


IMicrosoft Windows [人 本 6.1.7?681] ee 
瞩 权 所 有 <《c)》 2009 Michkosoft Cokpokhation。 保留 所 有 权利 。 


CNMsers\nhdministkhatok>adb install CGC:\Jsers dmninistrator MndroidStudioProjects 
GoolWeather\app—baidu—re lease .apk 








图 15.15 将 生成 的 APK 安 装 到 模拟 器 上 


adb ”install 命 令 的 后 面 加 上 APK 文 件 的 路 径 ， 就 可 以 将 该 APK 文 件 安 
装 到 模拟 器 上 了 。 我 们 使 用 同样 的 方法 将 百度 和 360 这 两 个 渠道 的 APK 
文件 都 安装 到 模拟 器 上 ， 结 果 如 图 15.16 所 示 。 


申 欧 360 息 在 欧 天 气 


图 15.16 模拟 器 上 的 安装 结果 


可 以 看 到 ， 目 前 模拟 器 上 有 3 个 版 本 的 酪 欧 天 气 ， 这 是 由 于 之 前 我 们 在 

productFlavors 中 和 窗 写 了 各 渠道 的 applicationId 属 性 ， 保 证 每 个 APK 文 

件 的 包 名 都 不 相同 ， 因 而 它们 才能 安装 到 同一 个 设备 上 面 。 男 外 ， 从 应 
用 名 上 来 看 ， 渠 道 差 异性 开发 工作 也 顺利 完成 了 。 


不 过 ， 上 面 的 例子 只 是 为 了 演示 生成 多 渠道 APK 功 能 而 特意 编写 的 ， 实 
际 上 我 们 并 没有 这 个 需求 。 现 在 将 productFlavors 闭 包 删 除 ， 恢 复 成 之 
前 的 APK 文 件 ， 我 们 准备 进行 上 架 操 作 。 


大 欧 百 度 版 











15.2 ”申请 360 开 发 者 账号 


目前 ， 酷 欧 天 气 的 APK 安 装 包 已 经 准备 好 了 ， 但 如 果 想 要 把 它 发 布 到 

360 应 用 商店 ， 还 需要 去 申请 一 个 360 开 发 者 账号 才 行 ， 申 请 地 址 

是 : http://dev.360.cn。 

打开 该 网 页 ， 在 页 面 顶 部 有 登录 和 注册 按钮 。 如 果 你 还 没有 360 账 号 ， 

则 需要 在 这 里 注册 一 个 新 的 账号 ， 如 果 你 之 前 已 经 有 360 账 号 了 ， 那 么 
直接 登录 就 可 以 了 。 

登录 成 功 之 后 打开 http://dev.360.cn/mod/developer 这 个 网 址 ， 来 申请 成 为 
开发 者 ， 如 图 15.17 所 示 。 





请 选择 注册 开发 者 类 型 


洛 个 人 开发 者 使 | 企业 开发 者 


图 15.17 选择 注册 开发 者 类 型 


这 里 可 以 选择 是 申请 成 为 个 人 开发 者 还 是 企业 开发 者 。 很 显然 ， 我 们 是 
以 个 人 的 吴 份 来 友 布 应 用 的 ， 那 么 点 击 个 人 开发 者 吏 可 以 了 。 


接 下 来 需要 填写 一 些 基本 信息 和 联系 方式 ， 如 图 15.18 所 示 。 





| 基本 信息 
注册 张 呈 ; Sinyu890807@126com 


开发 者 姓 各 : 


上 传 证 件 昭 : 上 传 
M ) ， 章 春 示 例 


个 人 身份 证 件 : 区 了 


图 15.18 ” 填 基 本 信息 和 联系 方式 


填写 元 基本 信息 之 后 向 下 深 动 继续 填写 联系 方式 ， 全 部 填写 完成 之 后 ， 
扩 击 屏幕 最 下 方 的 “同意 并 注册 开发 者 ”按钮 来 完成 注册 ， 如 图 15.19 所 
示 。 











四 我 已 阅读 并 同意 《360 移 动 开放 和 平台 服务 条 款 》 


同意 并 注册 开 友 者 


图 15.19 ”完成 开发 者 注册 
这 样 你 就 成 功 成 为 一 名 360 开 发 者 了 ! 





15.3 发布 应 用 程序 


接 下 来 我 们 开始 发 布 酷 欧 天 气 这 个 应 用 ， 还 是 在 浏览 器 访问 地 
址 : http://dev.360.cn， 你 会 在 界面 上 看 到 如 图 15.20 所 示 的 内 容 。 


软件 发 布 ， © 游戏 发 布 ， 


图 15.20 软件 发 布 和 游戏 发 布 
然后 点 击 软件 发 布 ， 就 会 显示 如 图 15.21 所 示 的 界面 。 


请 选择 软件 类 型 
发 布 软件 类 应 用 , 如 : 新 闻 类 应 用 ， 购 物 类 应 用 发 布 电子 书 应 用 ， 如 ; 单 本 小 说 、 杂 志 、 漫 画 等 


图 15.21 选择 软件 类 型 


我 们 需要 选择 是 发 布 软件 类 应 用 还 是 电子 书 类 应 用 ， 这 里 点 击 软件 。 接 
下 来 会 弹出 一 个 新 的 界面 让 我 们 上 传 APK 以 及 填写 应 用 信息 。 首 先 来 上 
传 APK 吧 ， 点 击 上 传 按钮 ， 选 择 带 有 正式 签名 的 APK 文 件 ， 然 后 就 会 目 
动 开 始 上 传 了 ， 上 传 完成 之 后 会 显示 如 图 15.22 所 示 的 界面 。 





安全 系数 。 您 的 应 用 安全 系 煞 示 


-| | 各 解 ， se SR 
me su 


图 15.22 上 传 APK 完 成 


这 个 界面 提醒 我 们 ， 目 前 应 用 的 安全 系数 较 低 ， 建 议 对 APK 进 行 加 固 。 
实际 上 这 个 是 360 应 用 商店 的 特殊 需求 ， 并 不 是 所 有 应 用 商店 都 要 求 进 
行 加 固 的 。 但 是 我 们 还 是 得 按照 它 的 要 求 来 修改 ， 不 然 审 核 可 能 会 不 通 


这 里 点 击 立 即 加 固 按钮 ，360 会 帮忙 我 们 将 原 APK 文 件 进行 加 回 ， 并 生 
成 一 个 新 的 APK 文 件 ， 如 图 15.23 所 示 。 








加 园 成 功 ， 请 下 载 后 重新 签名 ， 再 次 提交 审核 。 下 载 应 用 
温 要 提示 

1 .您 以 后 的 更 新 包 可 以 到 360 加 国保 加 国 并 签名 ， 再 上 传 平台 宗 核 

2 使 用 360in 固 助手 ,一 锥 完成 应 用 加 签名 打 漠 道 .发布 市 场 等 扣 作 。 立 如 
下 载 


图 15.23 ”加固 成 功 提示 


不 过 这 个 加 固 后 的 APK 文 件 是 没有 经 过 签名 的 ， 也 就 是 说 我 们 还 需要 将 
它 下 载 下 来 ， 然 后 手动 进行 签名 才 行 。 


点 击 下 载 应 用 按钮 ， 先 将 加 固 后 的 APK 文 件 下 载 下 来 。 接 下 来 的 工作 就 
有 点 烦琐 了 ， 因 为 Android Studio 中 并 没有 提供 对 一 个 未 签名 的 APK 直 接 
因此 我 们 只 能 通过 最 原始 的 方式 ， 使 用 jarsigner 命 











在 命令 行 界面 按照 以 下 格式 输入 签名 命令 : 


jarsigner -verbose -sigalg SHA1withRSA -digestalg SHA1 -keystore [keystore 文 件 路 径 ] -storepass [keystore 文 件 密码 ] [ 待 签名 APK 
路 径 ] [keystore 文 件 别名 ] 





将 [中 的 摘 述 蔡 换 成 keystore 文 件 的 具体 信息 承 能 签名 成 功 了 ， 注 意 [] 
守 


符号 是 不 需要 的 。 接 着 我 们 将 签名 后 的 APK 文 件 重 新 上 传 就 可 以 了 。 


APK 上 传 成 功 之 后 ， 接 下 来 需要 选择 应 用 的 分 类 ， 如 图 15.24 所 示 。 





分 类 : ”实用 工具 ， 天 气 ' © 


上 传 版 权证 明 ( 选 填 ) : 


版 权证 明 是 什么 ? 软 著 快 球 申 请 


图 15.24 选择 应 用 分 类 


这 里 我 们 将 应 用 分 类 选择 成 实用 工具 天气。 下面 还 有 一 个 上 传 版 权证 
明 的 选项 ， 这 是 一 个 选 填 项 ， 我 们 直接 忽略 就 可 以 了 。 


接着 同 下 深 动 网 页 ， 设 置 支持 的 语言 以 及 资费 类 型 ， 如 图 15.25 所 示 。 














支持 语言 : 简体 中 文 v | 
资费 类 型 : 免 颖 软件 v ©@ 





图 15.25 设置 支持 语言 和 资费 类 型 


继续 滚动 网 页 ， 下 面 需 要 填写 应 用 
所 示 。 








介 以 及 当前 版 本 介绍 ， 如 图 15.26 


起 


应 用 简介 : ” 酷 欧 天 气 是 一 款 基 于 Android 端 开源 的 天 气 预报 软件 ,具备 坦 看 入 
全 国 的 省 市 县 、 坦 询 任意 城市 天 气 、 自 由 切换 城市 、 手 动 更 新 天 
气 、 后 台 自动 更 新 天 气 等 功能 。 酮 欧 天 气 中 的 天 气 数据 由 和 风 天 
气 提供 ， 背 景 图 片 由 必 应 提供 ， 代 人 码 苯 循 Apache v2 License 开 源 
协议 。 本 软件 主要 作为 学 习 和 交流 使 用 。 


50-1500 字 ， 请 向 用 户 介 绍 一 下 你 的 应 用 。 


当前 版 本 介绍 : ” 酷 欧 天 气 是 一 款 基于 Android 庙 开源 的 天 气 预报 软件 ， 县 备 坦 看 。 
全 国 的 省 市 县 、 查 询 任意 城市 天 气 、 自 由 切换 城市 、 手 动 更 新 天 
气 、 后 台 自 动 更 新 天 气 等 功能 。 


50-400 字 人 符 ， 请 加 用 户 介绍 当前 应 用 版 本 及 更 新 内 容 。 
图 15.26 填写 应 用 简介 和 当前 版 本 介绍 
在 版 本 介绍 的 下 面 ，360 还 要 求 填写 一 项 隐私 权限 说 明 ， 由 于 酪 欧 天 气 
只 申请 了 一 个 网 络 权 限 ， 因 此 没什么 需要 说 明 的 ， 我 们 直接 忽略 这 一 项 
就 可 以 了 。 


继续 向 下 滚动 网 页 ， 接 下 来 需要 上 传 一 张 高 分 辨 率 的 应 用 图 标 ， 图 标 要 
求 是 512x512 像 素 的 PNG 格 式 图 片 ， 如 图 15.27 所 示 。 











4 
图 15.27 ”上传 高 分 辩 率 的 应 用 图 标 
上 传 好 了 图 标 ， 我 们 还 需要 提供 5 张 酷 欧 天 气 的 屏 既 截图 ， 点 击 上 传 截 


图 按钮 ， 然 后 选择 准备 好 的 图 片 即 可 ， 如 图 15.28 所 示 。 
应 用 截图 : ”请 上 传 4-33k 蕉 区 
i 知 栏 。 查看 示例 
GG 
MY 





图 15.28 上 传 屏 幕 截图 


继续 向 下 深 动 ， 还 有 一 个 审核 辅助 说 明 的 选 填 项 ， 我 们 也 直接 忽略 就 可 
以 了 。 最 后 就 是 一 些 和 额外 的 定制 选项 ， 如 图 15.29 所 示 。 


是 否 进行 云 测试 : 是 电 百 


Testin 云 测 


发 布 时 间 :和 审核 后 立即 发 布 中 定时 发 布 


图 15.29 ”额外 的 辅助 选项 
这 里 我 们 选择 不 进行 云 测试 ， 并 在 审核 后 立即 发 布 。 


激动 人 心 的 时 刻 终 于 到 了 ， 现 在 点 击 一 下 提交 审核 按钮 就 可 以 将 酷 欧 天 
气 发 布 到 360 应 用 商店 了 ， 这 时 会 显示 如 图 15.30 所 示 的 提示 。 





提交 成 功 ! 


我 们 将 在 一 个 工作 日 内 完成 审核 ， 通 过 邮件 和 短信 告知 结果 ， 请 注意 查收 。 


图 15.30 ”提交 成 功 提示 


由 于 360 会 对 我 们 的 应 用 程序 进行 审核 ， 接 下 来 义 进 入 了 等 得 当中 。 不 
过 还 好 ， 根 据 提示 来 看 ， 这 次 也 许 不 需要 等 太 信 。 


果不其然 ， 过 了 几 个 小 时 之 后 在 360 手 机 助手 上 搜索 酷 欧 天 气 关 键 字 ， 
就 可 以 看 到 这 个 应 用 已 经 成 功 上 线 了 ， 如 图 15.31 所 示 。 











Ea 





搜索 


日 


灵犀 语音 助手 
tlt 会 低语 研 


日 


酷 欧 天 气 
请 窜 语 


黑 迹 天 和 气 


Ep 后 斌 二 全 
心 


EE 
, same Ta | 


360 天 气 a 





图 15.31 搜索 酪 欧 天 气 关 键 字 
扩 击 进去 可 以 查看 应 用 的 详情 ， 如 图 15.32 所 示 。 


Ak 
会 导 





二 向 会 
国 安全 系数 ) @ 免费 ) @ 无 广告 


[实用 工具 | 酷 欧 天 气 是 一 款 基于 Android 端 开源 的 天 气 
预报 软件 ， 具 备查 看 全 国 的 省 市 县 、 查 询 任 意 城市 天 


用 户 评价 我 要 评 计 





图 15.32 查看 应 用 详情 


到 了 这 里 ， 我 们 就 将 应 用 程序 的 发 布 工作 全 部 完成 了 ， 之 后 你 应 该 尽 可 
能 地 多 为 你 的 应 用 进行 宣传 ， 因 为 用 户 越 多 ， 你 能 得 到 的 回报 就 越 大 。 
那么 如 何 才能 从 我 们 辛 辛 苦 苦 编写 的 程序 中 得 到 回报 呢 ? 方式 有 很 多 

种 ， 其 中 较为 常见 的 做 法 就 是 通过 广告 来 进行 列 利 ， 因 此 下 一 节 我 们 就 
学 习 一 下 ， 如 何在 应 用 程序 中 嵌入 广告 。 


15.4 上 般 入 广告 进行 俩 利 


谷歌 充分 考虑 到 了 可 以 在 Android 应 用 程序 中 舱 入 广告 来 让 开发 者 获得 
收入 ， 因 此 早早 地 就 收购 了 AdMob 公 司 。AdMob 创 立 于 2006 年 ， 是 全 
球 最 早 致力 于 在 移动 设备 上 提供 广告 服务 的 公司 之 一 ， 如 今 成 为 了 谷歌 
的 子 公 司 ，AdMob 的 广告 更 加 适合 在 Android 系 统 以 及 Google Play 上 面 
进行 投放 。 


不 过 对 于 国内 开发 者 来 说 ，AdMob 可 能 就 不 是 那么 适合 了 。 因 为 
AdMob 平 台 上 的 广告 大 多 都 是 英文 的 ， 中 文 广告 数 有 限 ， 并 且 将 
AdMob 账 户 中 的 钱 提取 到 银行 账户 中 也 比较 抹 烦 ， 因 此 这 里 我 们 束 不 准 
备 使 用 AdMob 了 ， 而 是 将 眼光 放 在 一 些 国 内 的 移动 广告 平台 上 面 。 在 国 
内 的 这 一 领域 ， 做 得 比较 好 的 移动 广告 平台 也 不 少 ， 其 中 我 个 人 认为 腾 
讯 广告 联盟 ( 原 广 点 通 ) 特别 专业 ， 因 此 我 们 就 选择 它 来 为 酷 欧 天 气 提 
供 广 告 服务 吧 。 

15.4.1 注册 腾讯 广告 联盟 账号 

下 面 开 始 动手 ， 首 先 第 一 步 我 们 需要 注册 一 个 腾讯 广告 联盟 的 账号 ， 注 
册 地 址 为 : http:/e.qq.com/dewindex.html。 

打开 该 网 页 ， 选 择 使 用 QQ 号 登录 ， 然 后 就 会 自动 跳 转 到 腾讯 广告 联盟 
的 注册 界面 ， 如 图 15.33 所 示 。 图 15.33 中 的 所 有 内 容 都 是 必 填 项 ， 我 们 


按照 实际 情况 来 填写 惑 可 以 了 ， 填 写 完 成 之 后 点 击 下 一 步 ， 如 图 15.34 
所 示 。 











会 员 类 型 : 个 人 ”请 选择 正确 的 会 员 类 型 ， 否则 无 法 获取 收益 


姓名 : 








身份 证 写 码 : 


联系 地 址 : 








手机 号 码 : 


电子 邮箱 : 


电子 邮箱 验证 码 : 获取 邮箱 验证 码 





注册 来 源 : w 


图 15.33 填写 个 人 信息 





收 款 方 : | 部委 


























开户 银行 : ”请 选择 = 
开户 行 所 在 地 : ”北京 市 w 东城 v 
支行 名 称 : 
银行 账号 : 
账号 确认 : 











支持 格式 仅 限 jpg,png, 太 小 2M 以 内 
选择 文件 | 未 选择 任何 文件 


图 15.34 填写 银行 卡 信息 


由 于 腾讯 广告 联盟 涉及 提现 服务 ， 因 此 我 们 还 需要 填写 银行 卡 信息 ， 并 
上 传 银行 卡 照片 。 填 写 完 成 之 后 继续 点 击 下 一 步 ， 如 图 15.35 所 示 。 


银行 卡 正面 照片 : 

















身份 证 正面 照片 : | 选择 文件 | 未 选择 任何 文件 


身份 证 反面 照片 : | 选择 文件 | 未 选择 任何 文件 


支持 格式 仆 限 jpg,png, 大 小 2M 以 内 
w 同意 《腾讯 广 点 通 移 动 联盟 开发 者 协议 > 





图 15.35 上 传 身份 证 照片 


最 后 ， 将 你 的 身份 证 正 反 面 照片 上 传 ， 点 击 提交 按钮 ， 就 能 提交 审核 
了 ， 如 图 15.36 所 示 。 





您 的 会 员 注册 已 提交 成 功 ， 我 们 会 在 1 个 工作 日 内 完成 审核 ， 请 耐心 等 待 。 


图 15.36 提交 审核 


只 要 你 前 面 填写 的 内 容 都 是 真实 有 效 的 ， 审 核 一 般 都 会 很 快 通过 ， 这 里 
我 们 只 需要 耐心 等 待 几 个 小 时 就 好 了 。 


15.4.2 ”新建 媒体 和 广告 位 


审核 通过 之 后 ， 我 们 就 可 以 进入 到 腾讯 广告 联盟 的 后 台 ， 开 始 给 酪 欧 天 
气 添加 广告 了 。 首 先 需要 进入 媒体 管理 界面 ， 点 击 新 建 媒 体 按 钮 ， 这 时 
会 显示 一 个 页 面 来 让 你 填写 应 用 的 相关 信息 ， 我 们 根据 提示 一 一 填 好 即 
可 ， 如 图 15.37 所 示 。 














系统 平台 : 品 者: Android 程 序 er iDS 程 序 
媒体 名 称 : 

关键 词 : 天 气 

媒体 类 别 : 生活 实用 vw ”天气 9 


酷 欧 天 气 是 一 款 基 于 android 端 开源 的 天 气 预报 软 
件 ， 具 备查 看 全 国 的 省 市 县 、 人 
自由 切换 城市 、 手 动 更 新 天 气 、 后 台 自 动 更 新 天 气 





媒体 简介 : 等 功能 
4 
程序 主 包 名 :| comicoolweather.androld 
媒体 状态 : 全 已 上 架 未 上 架 
详情 页 地 址 : | hitp: /fzhushou. 360. ndailindexjoof 


图 15.37 填写 应 用 的 相关 信息 


注意 这 里 需要 填写 一 个 详情 页 地 址 ， 也 就 是 酷 欧 天 气 在 360 应 用 商店 上 
的 详情 页 地 址 。 打 开 http:/zhushou.360.cn， 在 搜索 框 上 输入 “ 酷 欧 天 
气 ”， 束 能 找到 该 地 址 了 。 











填写 完成 之 后 点 击 下 一 步 ， 接 下 来 需要 下 载 SDK， 如 图 15.38 所 示 。 


媒体 名 称 : 酷 欧 天 气 
媒体 类 型 : | | Andriod 程 序 
应 用 ID : 1105585573 


' 虱 Andriod SDK 下 载 


图 15.38 ”下载 SDK 


点 击 Android SDK 下 载 按 钮 ， 先 把 SDK 下 载 下 来 ， 我 们 稍 后 就 会 进行 接 
入 。 继 续 点 击 下 一 步 ， 如 图 15.39 所 示 。 


媒体 名 称 : 酷 欧 天 气 


媒体 类 型 : a Andriod 程 序 
应 用 ID : 1105585573 
应 用 程序 : 上 人 苇 “二 输入 下 载 URL 





http://zhushou.360.cn/detail 





图 15.39 ”完成 媒体 创建 


这 里 要 求 填 入 一 个 APK 的 下 载 的 地 址 ， 我 们 直接 就 填 入 图 15.37 当 中 的 
详情 页 地 址 就 可 以 了 。 点 击 完 成 按钮 ， 现 在 又 会 进入 到 审核 等 待 当 中 。 


为 什么 新 建 媒 体 也 需要 进行 审核 呢 ? 这 是 因为 腾讯 为 了 防止 茶 些 开发 者 
在 垃圾 软件 上 面 投放 广告 ， 因 此 要 求 开 发 者 必须 提交 应 用 程序 的 APK 文 
件 进行 审核 ， 只 有 审核 通过 的 应 用 才 人 允许 进行 广告 投放 。 那 么 我 们 只 能 
0 审核 通过 之 后 ， 在 媒体 管理 界面 得 看 新 建 媒体 的 状态 ， 如 图 
15.40 所 示 。 





应 用 ID 媒体 名 称 ” ”联盟 开通 状态 。 业务 状态 系统 平台 ”。 摊 作 
1105585573 酷 欧 天 气 已 开通 正常 Android 修改 新 建 广告 位 


图 15.40 查看 新 建 媒 体 的 状态 
可 以 看 到 ， 联 盟 开 通 状 态 显 示 已 开通 ， 业 务 状态 显 示 正 常 ， 说 明 新 建 的 


媒体 已 经 通过 审核 了 。 注 意 这 里 还 自动 生成 了 一 个 应 用 ID， 我 们 稍 后 就 
会 用 到 。 


现在 点 击 新 建 广告 位 ， 束 可 以 来 创建 一 个 广告 位 了 了， 如 图 15.41 所 示 。 





新 建 广告 位 X 





媒体 选择 : 酷 欧 天 气 
广告 位 名 称 : 启动 广告 


广告 位 类 型 : Banner 广 告 应 用 增 插 屏 广告 “ 息 开展 广告 


屏蔽 行业 : 心理 健康 类 
星座 算命 类 
WP2P 网 贷 平 台 

如 果 对 于 某 些 类 型 的 广告 素材 (例如 成 人 用 品 ) 过 于 敏感 ， 您 可 以 进行 行业 广告 屏 殴 


图 15.41 新 建 广告 位 


首先 要 输入 广告 位 的 名 称 ， 然 后 选择 广告 了 位 的 闫 型 。 腾讯 广告 联盟 文 持 
Banner、 全 用 墙 插 屏 和 开 屏 这 4 种 广告 类 型 ， 具 体 每 种 广告 类 型 的 区 
别 你 可 以 通过 奉 阅 文档 进行 了 解 ， 这 里 我 们 选择 开 屏 广告 is 下 素 还 可 
= 告 进行 屏 珊 ， 选 择 完成 之 后 点 击 创 建 按钮 完成 广 
告 位 创建 。 


现在 进入 到 广告 位 管理 界面 ， 束 能 查看 到 我 们 刚刚 新 建 的 广告 位 了 ， 如 
图 15.42 所 示 。 


名 称 &ID 广告 位 类 型 所 属 应 用 &ID 业务 状态 广告 位 状态 操作 


启动 广告 栈 欧 天 气 


Fh 正 荣 
4010212448179536 1105585573 Se 


图 15.42 查看 新 建 广告 位 


其 中 ，4010212448179536 是 广告 位 ID，1105585573 是 应 用 ID。 有 了 这 两 
个 数据 之 后 ， 我 们 就 可 以 开始 接 入 广告 SDK 了 。 


15.4.3 接 入 广告 SDK 


首先 将 刚才 下 载 的 广告 SDK 压 缩 包 解压 ， 里 面 的 内 容 非 党 简单， 如 图 
15.43 所 示 。 


芍 


hh resources 

@ GDT DEV guide.4.9.html 

盖 GDTUnionDemo.zip 

车 | GDTUnionSDK.4.9.533.minJjar 


图 15.43 ”广告 SDK 压 缩 包 中 的 内 容 


其 中 resources 文 件 夹 中 放 的 是 一 些 资源 图 片 ， 我 们 使 用 不 到 。GDT DEV 
guide.4.9.html 是 广告 SDK 的 对 接 文 档 ，GDTUnionDemo.zip 是 广告 SDK 
的 对 接 示 例 ，GDTUnionSDK.4.9.533.min.jar 则 是 广告 SDK 中 最 主要 的 一 
个 Jar 包 文件 了 。 


由 于 腾讯 广告 SDK 中 的 功能 还 是 挺 多 的 ， 这 里 不 可 能 面面俱到 ， 将 每 一 
个 功能 都 进行 详细 地 讲解 。 因 此 我 准备 只 讲解 开 屏 广告 这 一 种 类 型 的 广 
告 用 法 ， 剩 下 的 其 他 功能 你 可 以 通过 阅读 文档 来 进行 学 习 。 

我 们 先 将 GDTUnionSDK.4.9.533.min.jar 复 制 到 appylibs 目 录 当 中 ， 并 点 击 
一 下 Android Studio 顶 部 工具 栏 中 的 Sync 按钮 完成 同步 。 


接着 在 AndroidManifest.xml 中 声明 以 下 权限 ， 其 中 网 络 访问 权限 是 之 前 
声明 过 的 ， 不 需要 声明 两 裔 。 





<uses-permission android : 
<uses-permission android : 
<uses-permission android : 
<uses-permission android : 
<uses-permission android : 
<uses-permission android : 
<uses-permission android : 


name="android. 
name="android. 
name="android. 
name="android. 
name="android. 
name="android. 
name="android. 


permission.INTERNET" /> 
permission.ACCESS_NETWORK_STATE" /> 
permission.ACCESS_ WIFI_STATE" /> 
permission.READ_ PHONE_STATE" /> 
permission.ACCESS_COARSE_LOCATION" /> 
permission.ACCESS_COARSE_UPDATES" /> 
permission.WRITE_EXTERNAL_STORAGE" /> 


注意 ， 其 中 READ_PHONE_STATE、ACCESS_COARSE_LOCATION 和 


WRITE_EXTERNAL_STORAGE 这 3 个 权限 是 危险 权限 ， 因 此 我 们 符 会 还 


行 运行 时 权限 处 理 。 


接 下 来 在 <applLication> 标 签 


<activity 


中 添加 如 下 内 容 : 


android:name="com.qq.e.ads.ADActivity" 


android:configChanges="keyboard|keyboardHidden|orientation|screenSize" /> 


<service 


android:name="com.qq.e.comm.DownloadService" 


android:exported="fal 


Sse" 7 





这 样 束 将 配置 工作 


完成 了 。 


然后 我 们 还 需要 创建 一 个 用 于 显示 开 屏 广告 的 活动 ， 石 击 


com.coolweather.android 包 ,New Activity- Empty Activity， 创 建 一 人 
SplashActivity， 并 将 布局 名 指定 成 activity_splash.xml。 





activity_splash.xml 中 的 代码 ， 如 下 所 示 : 


<RelativeLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 


android:id="@+id/cont 


android:layout_width= 


ainer" 


"match_parent" 


android:layout_height="match_parent"> 


</RelativeLayout> 


修改 


有 


需要 


进 


个 


只 有 一 个 空 的 RelativeLayout， 我 们 并 不 需要 在 RelativeLayout 当 中 
设 入 件 各 内 容 ， 但 是 必须 给 它 定 义 一 个 id。 


接着 修改 SplashActivity 中 的 代码 ， 如 下 所 示 : 


public class SplashActivity extends AppCompatActivity { 





private RelativeLayout container; 


/** 

















* 用 于 判断 是 否 可 以 跳 过 广告 ， 进 入 MainActivity 


private boolean canJump ; 


Q@override 


protected void onCreate(Bundle savedInstanceState) { 
Super .oncCcreate(SavedInstanceState) 
setContentView(R.1layout.activity_splash); 
container = (RelativeLayout) findViewById(R.id.container); 
// 进行 运行 时 权限 处 理 


} 

/x 
x 

pri 


} 


@Ov 
pro 


} 


@Ov 
pro 


} 


pri 


} 


@Ov 
pub 


List<String> permissionList = new ArrayList<>(); 

if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_ PHONE_ 
STATE) != PackageManager .PERMISSION GRANTED) { 
permissionList.add(Manifest.permission.READ_ PHONE_STATE); 


if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_ 
COARSE_LOCATION) != PackageManager .PERMISSION_ GRANTED) { 
permissionList.add(Manifest.permission.ACCESS COARSE_LOCATION); 

} 

if (ContextCompat .checkSelfPermission(this，Manifest.permission.WRITE_ 
EXTERNAL_STORAGE) != PackageManager .PERMISSION_GRANTED) { 
permissionList.add(Manifest.permission.WRITE_ EXTERNAL_STORAGE); 


if (!permissionList.isEmpty()) { 
String [] permissions = permissionList.toArray(new String[permissionList. 


size()]); 
ActivityCompat.requestPermissions(this, permissions, 1); 
} else { 
requestAds(); 
} 


请 求 开 屏 广告 


vate void requestAds() { 
String appId = "1105585573"; 
String adId = "4010212448179536" 
new SplashAD(this, container, appId, adId, new SplashADListener() { 
@Override 
public void onADDismissed() { 
// 广告 显示 完毕 
forward(); 


} 


@Override 

public void onNoAD(int i) { 
// 广告 加 载 失败 
forward() 


} 


@Override 

public void onADPresent() { 
// 广告 加 载 成 功 

} 


@Override 
public void onADClicked() { 
// 广告 被 点 击 


}); 


erride 

tected void onPause() { 
super .onPpause(); 
canJump = false; 


erride 
tected void onResume() { 
super .onResume( ); 
if (canJump) { 
forward() 


canJump = true; 


vate void forward() { 
if (canJump) { 
// 跳 转 到 MainActivity 
Intent intent = new Intent(this, MainActivity.class); 
startActivity(intent); 
finish(); 
} else { 
canJump = true; 
} 


erride 

lic void onRequestPermissionsResult(int requestCode, String[] permissions, 
int[] grantResults) { 

switch (requestCode) { 
CASO 1: 
if (grantResults.length > 0) { 
for (int result : grantResults) { 
if (result != PackageManager .PERMISSION_ GRANTED) { 
Toast .makeText (this, "必须 同意 所 有 权限 才能 使 用 本 程序 "， 
Toast .LENGTH_SHORT) .show( ); 

















finish(); 
return; 
} 
} 
requestAds(); 
} else { 








Toast .makeText(this，" 发 生 未 知 错误 "，Toast .LENGTH_SHORT).show(); 


可 以 看 到 ， 在 oncreate() 方 法 中 ， 我 们 先是 获取 到 了 RelativeLayout 的 实 
例 ， 紧 接着 就 开始 进行 运行 时 权限 处 理 。 由 于 这 里 也 是 需要 在 运行 时 一 
A 因此 采用 了 和 11.3.2 小 节 同 样 的 写法 ， 相 信 你 一 定 
不 会 陌生 吧 。 


当 用 户 同意 了 所 有 的 权限 申请 之 后 ， 就 会 调用 requestAds() 方 法 来 请 求 
广告 数据 。 在 requestAds() 方 法 中 我 们 先是 定义 了 appId 和 adId 这 两 个 变 
量 ， 它 们 的 值 就 是 在 腾讯 广告 联盟 后 台 生 成 的 应 用 ID 和 广告 位 ID， 然 后 
创建 SplashAD 的 实例 来 获取 广告 数据 。SplashAD 的 构造 函数 接收 5 个 参 
数 ， 第 1 个 参数 是 当前 活动 的 实例 ， 第 2 个 参数 是 RelativeLayout 的 实例 ， 
第 3 个 参数 是 应 用 ID， 第 4 个 参数 是 广告 位 ID， 相 信 前 4 个 参数 都 没什么 
需要 解释 的 。 第 5 个 参数 是 一 个 SplashADListener 的 实例 ， 用 于 监听 广告 
数据 的 回调 。 其 中 onApDDismissed() 方 法 会 在 广告 显示 完毕 时 回 

调 ，onNoApD() 方 法 会 在 广告 加 载 失败 时 回调 ，onApPresent () 方 法 会 在 广 
告 加 载 成 功 时 回调 ，onApclicked() 方 法 会 在 广告 被 点 击 时 回调 。 当 广 
告 显 示 完 毕 或 者 广告 加 载 失败 时 ， 我 们 调用 forward() 方 法 跳 转 到 
MainActivity， 并 将 当前 活动 关闭 即 可 。 


另外 注意 这 里 还 使 用 了 一 个 canJump 变 量 用 于 对 活动 跳 转 进行 控制 。 这 
是 因为 如 果 用 户 点 击 了 广告 ， 会 启动 一 个 新 的 活动 来 展示 广告 的 详细 内 
容 ， 这 个 时 候 即 使 回调 了 onApDDismissed() 方 法 ， 显 然 也 不 应 该 启动 
MainActivity， 因 此 我 们 在 onPause() 方 法 中 将 canJump 设 置 成 了 false。 
然后 在 forward() 方 法 中 发 现 canJump 是 false， 因 此 不 会 进行 跳 转 ， 但 
是 会 将 canJump 设 置 成 true。 最 后 ， 当 用 户 看 完了 广告 回 到 
SplashActivity 时 ，onResume() 方 法 将 会 执行 ， 这 个 时 候 发 现 canJump 

是 true， 因 此 就 会 调用 forward() 方 法 来 启动 MainActivity。 


整体 流程 大 概 就 是 这 个 样子 了 ， 接 下 来 我 们 还 需要 将 主 活动 设置 成 
SplashActivity 而 不 再 是 MainActivity， 人 否则 广告 界面 将 无 法 得 到 展示 。 
修改 AndroidManifest.xml 中 的 代码 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.coolweather .android" 
























































<application 


android:name="org.1Litepal.LitePalApplication" 
android:allowBackup="true 
android:icon= "@mipmap/1ogo" 
android:label= "Qty Ngapps name" 
android: supportsRt1=" 
android:theme= pT Tee 洲 
<activity android:name=" .MainActivity"> 
</activity> 
<activity android:name=".SplashActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 


</application> 


</manifest> 





这 样 我 们 就 将 广告 SDK 全 部 对 接 完成 了 ， 现 在 可 以 重新 运行 一 下 程序 来 
看 一 看 效果 。 不 过 需要 注意 ， 广 告 在 模拟 器 上 是 不 会 显示 的 ， 我 们 要 用 
真正 的 手机 测试 才 行 。 程 序 启 动 后 首先 会 弹出 运行 时 权限 的 申请 对 话 
框 ， 全 部 都 点 击 允 许 之 后 就 能 看 到 广告 数据 了 ， 如 图 15.44 所 示 。 























4 了” 往 情 深 





图 15.44 显示 广告 数据 


开 屏 广告 会 持续 5 秒 钟 时 间 ， 然 后 就 会 目 动 跳 转 到 MainActivity 中 ， 后 面 
的 流程 就 和 之 前 是 完全 一 样 的 了 。 


15.4.4 重新 发 布 应 用 程序 


现在 我 们 已 经 成 功 在 酷 欧 天 气 中 接 入 了 广告 功能 ， 那 么 是 时 候 将 这 个 新 
版 本 更 新 到 360 应 用 商店 上 了 。 


由 于 即将 发 布 的 会 是 新 一 版 的 酷 欧 天 气 ， 因 此 在 生成 安装 包 之 前 还 需要 
修改 一 下 应 用 程序 的 版 本 号 信息 。 编 辑 app/build.gradle 文 件 ， 如 下 所 








可 以 看 到 ， 这 里 将 versionCode 改 成 了 2，versionName 改 成 了 1.1。 需 要 注 
意 的 是 ， 每 个 版 本 的 versionCode 和 versionName 都 不 能 和 其 他 版 本 相 
同 ， 且 新 版 应 用 的 版 本 号 必须 大 于 老 版 应 用 的 版 本 号 。 


接 下 来 我 们 就 可 以 使 用 在 15.1 节 学 习 的 技术 来 生成 新 的 APK 文 件 ， 有 具体 
的 步骤 就 不 再 重复 介绍 了 ， 最 终 会 生成 一 个 新 的 app-release.apk 文 件 ， 
下 面 我 们 将 它 重新 发 布 到 360 应 用 商店 。 


打开 360 开 发 者 后 台 的 管理 中 心 页 面 ， 然 后 点 击 酪 欧 天 气 的 更 新 管理 按 
钮 ， 如 图 15.45 所 示 。 











酷 欧 天 气 “上 师 


安检 结果 :通过 查看 详情 


外 编辑 与 更 新 


图 15.45 更 新 酪 欧 天 气 


点 击 编辑 与 更 新 按钮 ， 就 能 上 传 新 的 APK 文 件 了 。 注 意 上 传 之 后 仍然 会 
5 我 们 只 需要 使 用 和 之 前 同样 的 方式 进行 加 固 
可 以 了 


另外 ， 由 于 新 版 的 酷 欧 天 气 中 增加 了 一 些 敏 感 隐 私 权 限 ， 因 此 我 们 还 需 
要 在 这 一 项 上 面 做 出 说 明 ， 如 图 15.46 所 示 。 


系统 检测 到 此 APK 文 件 调 用 了 用 户 手机 敏感 隐私 权限 ， 应 工信部 要 求 需 对 敏感 隐私 权限 的 获取 做 出 合理 说 明 。 
当前 APKAR 取 考 感 这 私 权限 列表 : 


0 装 歌 雪 避 化 得 
应 用 内 时 有 广告 功能 ， 需 获取 用 户 的 粗 上 略 位 置 来 显示 更 加 合理 的 广 ©@ 
告 。 


图 15.46 ”对 敏感 隐私 权限 进行 说 明 


现在 只 需要 点 击 页 面 最 下 方 的 提交 审核 按钮 ， 新 版 本 的 酷 欧 天 气 就 发 布 
成 功 ] ， 当 然 还 需要 通过 360 的 审核 才 行 。 以 后 每 当 有 用 户 观看 或 点 击 
了 应 用 程序 中 的 广告 时 ， 我 们 残 能 真正 地 得 到 收 荔 。 在 腾讯 广告 联盟 的 
后 台 管 理 界面 可 以 但 看 到 每 天 的 收益 情况 ， 如 图 15.47 所 示 。 





昨日 预 估 收 益 近 7 日 收益 本 月 累计 收益 账号 总 收益 
0.01 去 0.02 到 0.02 a 0.02 3 


图 15.47 查看 广告 收益 情况 


你 的 应 用 越 成 功 ， 所 获得 的 广告 收益 也 会 越 多 ， 因 此 赶快 去 编写 更 多 优 
Le 相信 通过 整 本 书 的 学 习 ， 你 已 经 有 足够 
I 能力 做 到 了 ! 


15.5 ”结束 语 


束 这 样 ， 本 书 所 有 的 内 容 你 都 学 完了 ， 现 在 你 已 经 成 功 毕 业 ， 并 且 成 为 
了 一 名 合格 的 Android 开 发 者 。 但 是 如 果 想 要 成 为 一 名 出 色 的 Android 开 
发 者 ， 光 靠 本 书 中 的 这 些 理论 知识 以 及 少量 的 实践 还 是 不 够 的 ， 你 需要 
真正 步 入 到 工作 岗位 当中 ， 通 过 更 多 的 项 目 实战 来 不 断 地 历练 和 提升 自 
Es 


哮 蝶 了 整 本 书 的 话 ， 但 是 到 了 最 后 却 不 知道 该 说 点 什么 好 ， 我 不 想 说 我 

能 教 你 的 就 只 有 这 些 了 ， 因 为 实际 上 我 想 教 你 或 者 和 你 一 起 探讨 的 内 容 

还 有 很 多 很 多 ， 不 过 限于 篇 幅 的 原因 ， 本 书 的 内 容 就 只 能 到 此 为 止 了 。 

但 我 会 长 期 在 博客 和 微 信 公众 号 上 面 分 享 更 多 Android 相 关 的 技术 文 

章 ， 如 果 感 兴趣 的 话 ， 可 以 到 我 的 博客 和 公众 号 中 继续 学 习 。 当 然 ， 如 

人 0 
Ps 














http://guolin.tech 
扫 一 扫 下 方 二 维 码 即 可 关注 我 的 公众 号 : 








好 了 ， 束 到 这 里 吧 ， 视 愿 你 未 来 的 Android 之 旅 都 能 恰 快 。 


看 完了 


如 果 您 对 本 书 内 容 有 疑问 ， 可 发 邮件 至 contact@turingbook.com， 会 有 编 
辑 或 作 译 者 协助 答疑 。 也 可 访问 图 灵 社 区 ， 参 与 本 书 讨论 。 


如 果 是 有 关 电 子 书 的 建议 或 问题 ， 请 联系 专用 客服 邮箱 : 


ebookturingbook.com。 


在 这 里 可 以 找到 我 们 : 











微 博 @ 图 灵 教 育 : 好 书 、 活 动 每 日 播报 

微 博 @ 图 灵 社 区 : 电子 书 和 好 文章 的 消息 

微 博 @ 图 灵 新 知 : 图 灵 教 育 的 科普 小 组 

微 信 图 灵 访 谈 : ituring_interview， 讲 述 码 农 精彩 人 生 
微 信 图 灵 教 育 : turingbooks 








图 灵 社 区 会 员 人 民 邮 电 出 版 社 (zhanghaichuan@ptpress.com.cn)” 专 享 
尊重 版 权 
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